diff --git a/doc/source/devref/layer3.rst b/doc/source/devref/layer3.rst
index 1edd8c8887f..e64581bc2a5 100644
--- a/doc/source/devref/layer3.rst
+++ b/doc/source/devref/layer3.rst
@@ -30,44 +30,62 @@ Neutron logical network setup
-----------------------------
::
- vagrant@precise64:~/devstack$ neutron net-list
- +--------------------------------------+---------+--------------------------------------------------+
- | id | name | subnets |
- +--------------------------------------+---------+--------------------------------------------------+
- | 84b6b0cc-503d-448a-962f-43def05e85be | public | 3a56da7c-2f6e-41af-890a-b324d7bc374d |
- | a4b4518c-800d-4357-9193-57dbb42ac5ee | private | 1a2d26fb-b733-4ab3-992e-88554a87afa6 10.0.0.0/24 |
- +--------------------------------------+---------+--------------------------------------------------+
- vagrant@precise64:~/devstack$ neutron subnet-list
- +--------------------------------------+------+-------------+--------------------------------------------+
- | id | name | cidr | allocation_pools |
- +--------------------------------------+------+-------------+--------------------------------------------+
- | 1a2d26fb-b733-4ab3-992e-88554a87afa6 | | 10.0.0.0/24 | {"start": "10.0.0.2", "end": "10.0.0.254"} |
- +--------------------------------------+------+-------------+--------------------------------------------+
- vagrant@precise64:~/devstack$ neutron port-list
- +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+
- | id | name | mac_address | fixed_ips |
- +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+
- | 0ba8700e-da06-4318-8fe9-00676dd994b8 | | fa:16:3e:78:43:5b | {"subnet_id": "1a2d26fb-b733-4ab3-992e-88554a87afa6", "ip_address": "10.0.0.1"} |
- | b2044570-ad52-4f31-a2c3-5d767dc9a8a7 | | fa:16:3e:5b:cf:4c | {"subnet_id": "1a2d26fb-b733-4ab3-992e-88554a87afa6", "ip_address": "10.0.0.3"} |
- | bb60d1bb-0cab-41cb-9678-30d2b2fdb169 | | fa:16:3e:af:a9:bd | {"subnet_id": "1a2d26fb-b733-4ab3-992e-88554a87afa6", "ip_address": "10.0.0.2"} |
- +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+
+ vagrant@precise64:~/devstack$ openstack network list
+ +--------------------------------------+---------+----------------------------------------------------------------------------+
+ | ID | Name | Subnets |
+ +--------------------------------------+---------+----------------------------------------------------------------------------+
+ | 6ece2847-971b-487a-9c7b-184651ebbc82 | public | 0d9c4261-4046-462f-9d92-64fb89bc3ae6, 9e90b059-da97-45b8-8cb8-f9370217e181 |
+ | 713bae25-8276-4e0a-a453-e59a1d65425a | private | 6fa3bab9-103e-45d5-872c-91f21b52ceda, c5c9f5c2-145d-46d2-a513-cf675530eaed |
+ +--------------------------------------+---------+----------------------------------------------------------------------------+
+
+ vagrant@precise64:~/devstack$ openstack subnet list
+ +--------------------------------------+---------------------+--------------------------------------+--------------------+
+ | ID | Name | Network | Subnet |
+ +--------------------------------------+---------------------+--------------------------------------+--------------------+
+ | 0d9c4261-4046-462f-9d92-64fb89bc3ae6 | public-subnet | 6ece2847-971b-487a-9c7b-184651ebbc82 | 172.24.4.0/24 |
+ | 6fa3bab9-103e-45d5-872c-91f21b52ceda | ipv6-private-subnet | 713bae25-8276-4e0a-a453-e59a1d65425a | 2001:db8:8000::/64 |
+ | 9e90b059-da97-45b8-8cb8-f9370217e181 | ipv6-public-subnet | 6ece2847-971b-487a-9c7b-184651ebbc82 | 2001:db8::/64 |
+ | c5c9f5c2-145d-46d2-a513-cf675530eaed | private-subnet | 713bae25-8276-4e0a-a453-e59a1d65425a | 10.0.0.0/24 |
+ +--------------------------------------+---------------------+--------------------------------------+--------------------+
+
+ vagrant@precise64:~/devstack$ openstack port list
+ +--------------------------------------+------+-------------------+----------------------------------------------------------------------------------------------------+--------+
+ | ID | Name | MAC Address | Fixed IP Addresses | Status |
+ +--------------------------------------+------+-------------------+----------------------------------------------------------------------------------------------------+--------+
+ | 420abb60-2a5a-4e80-90a3-3ff47742dc53 | | fa:16:3e:2d:5c:4e | ip_address='172.24.4.7', subnet_id='0d9c4261-4046-462f-9d92-64fb89bc3ae6' | ACTIVE |
+ | | | | ip_address='2001:db8::1', subnet_id='9e90b059-da97-45b8-8cb8-f9370217e181' | |
+ | b42d789d-c9ed-48a1-8822-839c4599301e | | fa:16:3e:0a:ff:24 | ip_address='10.0.0.1', subnet_id='c5c9f5c2-145d-46d2-a513-cf675530eaed' | ACTIVE |
+ | cfff6574-091c-4d16-a54b-5b7f3eab89ce | | fa:16:3e:a0:a3:9e | ip_address='10.0.0.2', subnet_id='c5c9f5c2-145d-46d2-a513-cf675530eaed' | ACTIVE |
+ | | | | ip_address='2001:db8:8000:0:f816:3eff:fea0:a39e', subnet_id='6fa3bab9-103e-45d5-872c-91f21b52ceda' | |
+ | e3b7fede-277e-4c72-b66c-418a582b61ca | | fa:16:3e:13:dd:42 | ip_address='2001:db8:8000::1', subnet_id='6fa3bab9-103e-45d5-872c-91f21b52ceda' | ACTIVE |
+ +--------------------------------------+------+-------------------+----------------------------------------------------------------------------------------------------+--------+
+
+
+ vagrant@precise64:~/devstack$ openstack subnet show c5c9f5c2-145d-46d2-a513-cf675530eaed
+ +-------------------+--------------------------------------+
+ | Field | Value |
+ +-------------------+--------------------------------------+
+ | allocation_pools | 10.0.0.2-10.0.0.254 |
+ | cidr | 10.0.0.0/24 |
+ | created_at | 2016-11-08T21:55:22Z |
+ | description | |
+ | dns_nameservers | |
+ | enable_dhcp | True |
+ | gateway_ip | 10.0.0.1 |
+ | host_routes | |
+ | id | c5c9f5c2-145d-46d2-a513-cf675530eaed |
+ | ip_version | 4 |
+ | ipv6_address_mode | None |
+ | ipv6_ra_mode | None |
+ | name | private-subnet |
+ | network_id | 713bae25-8276-4e0a-a453-e59a1d65425a |
+ | project_id | 35e3820f7490493ca9e3a5e685393298 |
+ | revision_number | 2 |
+ | service_types | |
+ | subnetpool_id | b1f81d96-d51d-41f3-96b5-a0da16ad7f0d |
+ | updated_at | 2016-11-08T21:55:22Z |
+ +-------------------+--------------------------------------+
- vagrant@precise64:~/devstack$ neutron subnet-show 1a2d26fb-b733-4ab3-992e-88554a87afa6
- +------------------+--------------------------------------------+
- | Field | Value |
- +------------------+--------------------------------------------+
- | allocation_pools | {"start": "10.0.0.2", "end": "10.0.0.254"} |
- | cidr | 10.0.0.0/24 |
- | dns_nameservers | |
- | enable_dhcp | True |
- | gateway_ip | 10.0.0.1 |
- | host_routes | |
- | id | 1a2d26fb-b733-4ab3-992e-88554a87afa6 |
- | ip_version | 4 |
- | name | |
- | network_id | a4b4518c-800d-4357-9193-57dbb42ac5ee |
- | tenant_id | 3368290ab10f417390acbb754160dbb2 |
- +------------------+--------------------------------------------+
Neutron logical router setup
@@ -75,30 +93,44 @@ Neutron logical router setup
::
- vagrant@precise64:~/devstack$ neutron router-list
- +--------------------------------------+---------+--------------------------------------------------------+
- | id | name | external_gateway_info |
- +--------------------------------------+---------+--------------------------------------------------------+
- | 569469c7-a2a5-4d32-9cdd-f0b18a13f45e | router1 | {"network_id": "84b6b0cc-503d-448a-962f-43def05e85be"} |
- +--------------------------------------+---------+--------------------------------------------------------+
- vagrant@precise64:~/devstack$ neutron router-show router1
- +-----------------------+--------------------------------------------------------+
- | Field | Value |
- +-----------------------+--------------------------------------------------------+
- | admin_state_up | True |
- | external_gateway_info | {"network_id": "84b6b0cc-503d-448a-962f-43def05e85be"} |
- | id | 569469c7-a2a5-4d32-9cdd-f0b18a13f45e |
- | name | router1 |
- | routes | |
- | status | ACTIVE |
- | tenant_id | 3368290ab10f417390acbb754160dbb2 |
- +-----------------------+--------------------------------------------------------+
- vagrant@precise64:~/devstack$ neutron router-port-list router1
- +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+
- | id | name | mac_address | fixed_ips |
- +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+
- | 0ba8700e-da06-4318-8fe9-00676dd994b8 | | fa:16:3e:78:43:5b | {"subnet_id": "1a2d26fb-b733-4ab3-992e-88554a87afa6", "ip_address": "10.0.0.1"} |
- +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+
+ vagrant@precise64:~/devstack$ openstack router list
+ +--------------------------------------+---------+--------+-------+-------------+-------+----------------------------------+
+ | ID | Name | Status | State | Distributed | HA | Project |
+ +--------------------------------------+---------+--------+-------+-------------+-------+----------------------------------+
+ | 82fa9a47-246e-4da8-a864-53ea8daaed42 | router1 | ACTIVE | UP | False | False | 35e3820f7490493ca9e3a5e685393298 |
+ +--------------------------------------+---------+--------+-------+-------------+-------+----------------------------------+
+ vagrant@precise64:~/devstack$ openstack router show router1
+ +-------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
+ | Field | Value |
+ +-------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
+ | admin_state_up | UP |
+ | availability_zone_hints | |
+ | availability_zones | nova |
+ | created_at | 2016-11-08T21:55:30Z |
+ | description | |
+ | distributed | False |
+ | external_gateway_info | {"network_id": "6ece2847-971b-487a-9c7b-184651ebbc82", "enable_snat": true, "external_fixed_ips": [{"subnet_id": "0d9c4261-4046-462f- |
+ | | 9d92-64fb89bc3ae6", "ip_address": "172.24.4.7"}, {"subnet_id": "9e90b059-da97-45b8-8cb8-f9370217e181", "ip_address": "2001:db8::1"}]} |
+ | flavor_id | None |
+ | ha | False |
+ | id | 82fa9a47-246e-4da8-a864-53ea8daaed42 |
+ | name | router1 |
+ | project_id | 35e3820f7490493ca9e3a5e685393298 |
+ | revision_number | 8 |
+ | routes | |
+ | status | ACTIVE |
+ | updated_at | 2016-11-08T21:55:51Z |
+ +-------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
+ vagrant@precise64:~/devstack$ openstack port list --router router1
+ +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+--------+
+ | ID | Name | MAC Address | Fixed IP Addresses | Status |
+ +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+--------+
+ | 420abb60-2a5a-4e80-90a3-3ff47742dc53 | | fa:16:3e:2d:5c:4e | ip_address='172.24.4.7', subnet_id='0d9c4261-4046-462f-9d92-64fb89bc3ae6' | ACTIVE |
+ | | | | ip_address='2001:db8::1', subnet_id='9e90b059-da97-45b8-8cb8-f9370217e181' | |
+ | b42d789d-c9ed-48a1-8822-839c4599301e | | fa:16:3e:0a:ff:24 | ip_address='10.0.0.1', subnet_id='c5c9f5c2-145d-46d2-a513-cf675530eaed' | ACTIVE |
+ | e3b7fede-277e-4c72-b66c-418a582b61ca | | fa:16:3e:13:dd:42 | ip_address='2001:db8:8000::1', subnet_id='6fa3bab9-103e-45d5-872c-91f21b52ceda' | ACTIVE |
+ +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------+--------+
+
See the `Networking Guide `_
for more detail on the creation of networks, subnets, and routers.
@@ -185,12 +217,12 @@ Finding the router in ip/ipconfig
For example::
- vagrant@precise64:~$ neutron router-list
- +--------------------------------------+---------+--------------------------------------------------------+
- | id | name | external_gateway_info |
- +--------------------------------------+---------+--------------------------------------------------------+
- | ad948c6e-afb6-422a-9a7b-0fc44cbb3910 | router1 | {"network_id": "e6634fef-03fa-482a-9fa7-e0304ce5c995"} |
- +--------------------------------------+---------+--------------------------------------------------------+
+ vagrant@precise64:~$ openstack router list
+ +--------------------------------------+---------+-------------------------------------------------------------------------+
+ | ID | Name | Status | State | Distributed | HA | Project |
+ +--------------------------------------+---------+-------------------------------------------------------------------------+
+ | ad948c6e-afb6-422a-9a7b-0fc44cbb3910 | router1 | Active | UP | True | False | 35e3820f7490493ca9e3a5e685393298 |
+ +--------------------------------------+---------+-------------------------------------------------------------------------+
vagrant@precise64:~/devstack$ sudo ip netns exec qrouter-ad948c6e-afb6-422a-9a7b-0fc44cbb3910 ip addr list
18: lo: mtu 16436 qdisc noqueue state UNKNOWN
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00