From 5aa8eb99c87665f741aa0ec0c034d3e45f55724c Mon Sep 17 00:00:00 2001 From: yanpuqing Date: Wed, 6 Jun 2018 06:11:58 -0400 Subject: [PATCH] Change neutron CLI to openstack CLI in neutron doc neutron CLI is deprecated and will be removed in the future. Use openstack CLI instead. Change-Id: I00fa6ee2e2ac19627a172ff49a55fe664e4f5c43 Closes-Bug: 1749801 --- .../admin/config-bgp-dynamic-routing.rst | 103 +++-- doc/source/admin/config-dns-int-ext-serv.rst | 414 ++++++++++-------- doc/source/admin/config-dns-int.rst | 135 +++--- doc/source/admin/config-dvr-ha-snat.rst | 4 +- doc/source/admin/config-rbac.rst | 2 +- doc/source/admin/config-service-subnets.rst | 6 +- doc/source/admin/ops-resource-tags.rst | 237 ++++++---- .../shared/deploy-ha-vrrp-initialnetworks.txt | 3 +- .../deploy-selfservice-initialnetworks.txt | 3 +- 9 files changed, 518 insertions(+), 389 deletions(-) diff --git a/doc/source/admin/config-bgp-dynamic-routing.rst b/doc/source/admin/config-bgp-dynamic-routing.rst index 5a3faf1e291..d6bafc08f5e 100644 --- a/doc/source/admin/config-bgp-dynamic-routing.rst +++ b/doc/source/admin/config-bgp-dynamic-routing.rst @@ -249,32 +249,33 @@ Create the provider and self-service networks .. code-block:: console - $ neutron subnet-create --name provider --subnetpool provider \ - --prefixlen 24 --allocation-pool start=203.0.113.11,end=203.0.113.254 \ - --gateway 203.0.113.1 provider - Created a new subnet: - +-------------------+---------------------------------------------------+ - | Field | Value | - +-------------------+---------------------------------------------------+ - | allocation_pools | {"start": "203.0.113.11", "end": "203.0.113.254"} | - | cidr | 203.0.113.0/24 | - | created_at | 2016-03-17T23:17:16 | - | description | | - | dns_nameservers | | - | enable_dhcp | True | - | gateway_ip | 203.0.113.1 | - | host_routes | | - | id | 8ed65d41-2b2a-4f3a-9f92-45adb266e01a | - | ip_version | 4 | - | ipv6_address_mode | | - | ipv6_ra_mode | | - | name | provider | - | network_id | 68ec148c-181f-4656-8334-8f4eb148689d | - | subnetpool_id | 3771c0e7-7096-46d3-a3bd-699c58e70259 | - | tags | [] | - | tenant_id | b3ac05ef10bf441fbf4aa17f16ae1e6d | - | updated_at | 2016-03-17T23:17:16 | - +-------------------+---------------------------------------------------+ + $ openstack subnet create --subnet-pool provider \ + --prefix-length 24 --gateway 203.0.113.1 --network provider \ + --allocation-pool start=203.0.113.11,end=203.0.113.254 provider + +-------------------+--------------------------------------+ + | Field | Value | + +-------------------+--------------------------------------+ + | allocation_pools | 203.0.113.11-203.0.113.254 | + | cidr | 203.0.113.0/24 | + | created_at | 2016-03-17T23:17:16 | + | description | | + | dns_nameservers | | + | enable_dhcp | True | + | gateway_ip | 203.0.113.1 | + | host_routes | | + | id | 8ed65d41-2b2a-4f3a-9f92-45adb266e01a | + | ip_version | 4 | + | ipv6_address_mode | None | + | ipv6_ra_mode | None | + | name | provider | + | network_id | 68ec148c-181f-4656-8334-8f4eb148689d | + | project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d | + | segment_id | None | + | service_types | | + | subnetpool_id | 3771c0e7-7096-46d3-a3bd-699c58e70259 | + | tags | | + | updated_at | 2016-03-17T23:17:16 | + +-------------------+--------------------------------------+ .. note:: @@ -380,13 +381,12 @@ Create the provider and self-service networks .. code-block:: console - $ neutron subnet-create --name selfservice1 --subnetpool selfservice \ - --prefixlen 25 selfservice1 - Created a new subnet: + $ openstack subnet create --network selfservice1 --subnet-pool selfservice \ + --prefix-length 25 selfservice1 +-------------------+----------------------------------------------------+ | Field | Value | +-------------------+----------------------------------------------------+ - | allocation_pools | {"start": "192.0.2.2", "end": "192.0.2.127"} | + | allocation_pools | 192.0.2.2-192.0.2.127 | | cidr | 192.0.2.0/25 | | created_at | 2016-03-17T23:20:20 | | description | | @@ -400,6 +400,7 @@ Create the provider and self-service networks | ipv6_ra_mode | | | name | selfservice1 | | network_id | be79de1e-5f56-11e6-9dfb-233e41cec48c | + | project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d | | revision_number | 1 | | subnetpool_id | c7e9737a-cfd3-45b5-a861-d1cee1135a92 | | tags | [] | @@ -407,13 +408,12 @@ Create the provider and self-service networks | updated_at | 2016-03-17T23:20:20 | +-------------------+----------------------------------------------------+ - $ neutron subnet-create --name selfservice2 --subnetpool selfservice \ - --prefixlen 25 selfservice2 - Created a new subnet: + $ openstack subnet create --network selfservice2 --subnet-pool selfservice \ + --prefix-length 25 selfservice2 +-------------------+------------------------------------------------+ | Field | Value | +-------------------+------------------------------------------------+ - | allocation_pools | {"start": "192.0.2.130", "end": "192.0.2.254"} | + | allocation_pools | 192.0.2.130-192.0.2.254 | | cidr | 192.0.2.128/25 | | created_at | 2016-03-17T23:20:20 | | description | | @@ -427,6 +427,7 @@ Create the provider and self-service networks | ipv6_ra_mode | | | name | selfservice2 | | network_id | c1fd9846-5f56-11e6-a8ac-0f998d9cc0a2 | + | project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d | | revision_number | 1 | | subnetpool_id | c7e9737a-cfd3-45b5-a861-d1cee1135a92 | | tags | [] | @@ -439,12 +440,11 @@ Create the provider and self-service networks .. code-block:: console - $ neutron subnet-create --name subnet3 selfservice3 198.51.100.0/24 - Created a new subnet: + $ openstack subnet create --network selfservice3 --prefix 198.51.100.0/24 subnet3 +-------------------+----------------------------------------------------+ | Field | Value | +-------------------+----------------------------------------------------+ - | allocation_pools | {"start": "198.51.100.2", "end": "198.51.100.254"} | + | allocation_pools | 198.51.100.2-198.51.100.254 | | cidr | 198.51.100.0/24 | | created_at | 2016-03-17T23:20:20 | | description | | @@ -458,6 +458,7 @@ Create the provider and self-service networks | ipv6_ra_mode | | | name | selfservice3 | | network_id | c283dc1c-5f56-11e6-bfb6-efc30e1eb73b | + | project_id | b3ac05ef10bf441fbf4aa17f16ae1e6d | | revision_number | 1 | | subnetpool_id | | | tags | [] | @@ -548,27 +549,21 @@ Create and configure the routers .. code-block:: console - $ neutron router-interface-add router1 selfservice1 - Added interface 90e3880a-5f5c-11e6-914c-9f3e20c8c151 to router router1. + $ openstack router add subnet router1 selfservice1 - $ neutron router-interface-add router2 selfservice2 - Added interface 91628362-5f5c-11e6-826a-7322fb03a821 to router router2. + $ openstack router add subnet router2 selfservice2 - $ neutron router-interface-add router3 selfservice3 - Added interface 91d51044-5f5c-11e6-bf55-ffd180541cc2 to router router3. + $ openstack router add subnet router3 selfservice3 #. Add the provider network as a gateway on each router. .. code-block:: console - $ neutron router-gateway-set router1 provider - Set gateway for router router1 + $ openstack router set --external-gateway provider router1 - $ neutron router-gateway-set router2 provider - Set gateway for router router2 + $ openstack router set --external-gateway provider router2 - $ neutron router-gateway-set router3 provider - Set gateway for router router3 + $ openstack router set --external-gateway provider router3 Create and configure the BGP speaker ------------------------------------ @@ -815,13 +810,13 @@ assist with verifying operation of the BGP speaker. .. code-block:: console - $ neutron port-list --device_owner="network:floatingip_agent_gateway" + $ openstack port list --device-owner network:floatingip_agent_gateway +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+ - | id | name | mac_address | fixed_ips | + | ID | Name | MAC Address | Fixed IP Addresses | +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+ - | 87cf2970-4970-462e-939e-00e808295dfa | | fa:16:3e:7c:68:e3 | {"subnet_id": "8ed65d41-2b2a-4f3a-9f92-45adb266e01a", "ip_address": "203.0.113.12"} | - | 8d218440-0d2e-49d0-8a7b-3266a6146dc1 | | fa:16:3e:9d:78:cf | {"subnet_id": "8ed65d41-2b2a-4f3a-9f92-45adb266e01a", "ip_address": "203.0.113.13"} | - | 87cf2970-4970-462e-939e-00e802281dfa | | fa:16:3e:6b:18:e0 | {"subnet_id": "8ed65d41-2b2a-4f3a-9f92-45adb266e01a", "ip_address": "203.0.113.14"} | + | 87cf2970-4970-462e-939e-00e808295dfa | | fa:16:3e:7c:68:e3 | ip_address='203.0.113.12', subnet_id='8ed65d41-2b2a-4f3a-9f92-45adb266e01a' | + | 8d218440-0d2e-49d0-8a7b-3266a6146dc1 | | fa:16:3e:9d:78:cf | ip_address='203.0.113.13', subnet_id='8ed65d41-2b2a-4f3a-9f92-45adb266e01a' | + | 87cf2970-4970-462e-939e-00e802281dfa | | fa:16:3e:6b:18:e0 | ip_address='203.0.113.14', subnet_id='8ed65d41-2b2a-4f3a-9f92-45adb266e01a' | +--------------------------------------+------+-------------------+--------------------------------------------------------------------------------------------------------+ IPv6 diff --git a/doc/source/admin/config-dns-int-ext-serv.rst b/doc/source/admin/config-dns-int-ext-serv.rst index 1baba6ac22e..2cf4ec101c1 100644 --- a/doc/source/admin/config-dns-int-ext-serv.rst +++ b/doc/source/admin/config-dns-int-ext-serv.rst @@ -127,27 +127,39 @@ Following is an example of these steps: $ neutron net-update 38c5e950-b450-4c30-83d4-ee181c28aad3 --dns_domain example.org. Updated network: 38c5e950-b450-4c30-83d4-ee181c28aad3 - $ neutron net-show 38c5e950-b450-4c30-83d4-ee181c28aad3 - +-------------------------+--------------------------------------+ - | Field | Value | - +-------------------------+--------------------------------------+ - | admin_state_up | True | - | availability_zone_hints | | - | availability_zones | nova | - | dns_domain | example.org. | - | id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | - | mtu | 1450 | - | name | private | - | port_security_enabled | True | - | revision_number | 1 | - | router:external | False | - | shared | False | - | status | ACTIVE | - | subnets | 43414c53-62ae-49bc-aa6c-c9dd7705818a | - | | 5b9282a1-0be1-4ade-b478-7868ad2a16ff | - | tags | [] | - | tenant_id | d5660cb1e6934612a01b4fb2fb630725 | - +-------------------------+--------------------------------------+ + $ openstack network show 38c5e950-b450-4c30-83d4-ee181c28aad3 + +---------------------------+--------------------------------------+ + | Field | Value | + +---------------------------+--------------------------------------+ + | admin_state_up | UP | + | availability_zone_hints | | + | availability_zones | nova | + | created_at | 2016-05-04T19:27:34Z | + | description | | + | dns_domain | example.org. | + | id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | + | ipv4_address_scope | None | + | ipv6_address_scope | None | + | is_default | None | + | is_vlan_transparent | None | + | mtu | 1450 | + | name | private | + | port_security_enabled | True | + | project_id | d5660cb1e6934612a01b4fb2fb630725 | + | provider:network_type | vlan | + | provider:physical_network | None | + | provider:segmentation_id | 24 | + | qos_policy_id | None | + | revision_number | 1 | + | router:external | Internal | + | segments | None | + | shared | False | + | status | ACTIVE | + | subnets | 43414c53-62ae-49bc-aa6c-c9dd7705818a | + | | 5b9282a1-0be1-4ade-b478-7868ad2a16ff | + | tags | | + | updated_at | 2016-05-04T19:27:34Z | + +---------------------------+--------------------------------------+ $ openstack server create --image cirros --flavor 42 \ --nic net-id=38c5e950-b450-4c30-83d4-ee181c28aad3 my_vm @@ -190,40 +202,51 @@ Following is an example of these steps: | 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 | my_vm | ACTIVE | - | Running | private=fda4:653e:71b0:0:f816:3eff:fe16:b5f2, 192.0.2.15 | cirros | +--------------------------------------+-------+--------+------------+-------------+----------------------------------------------------------+------------+ - $ neutron port-list --device_id 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 - +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ - | id | name | mac_address | fixed_ips | - +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ - | da0b1f75-c895-460f-9fc1-4d6ec84cf85f | | fa:16:3e:16:b5:f2 | {"subnet_id": "5b9282a1-0be1-4ade-b478-7868ad2a16ff", "ip_address": "192.0.2.15"} | - | | | | {"subnet_id": "43414c53-62ae-49bc-aa6c-c9dd7705818a", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe16:b5f2"} | - +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ + $ openstack port list --device-id 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 + +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+--------+ + | ID | Name | MAC Address | Fixed IP Addresses | Status | + +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+--------+ + | da0b1f75-c895-460f-9fc1-4d6ec84cf85f | | fa:16:3e:16:b5:f2 | ip_address='192.0.2.15', subnet_id='5b9282a1-0be1-4ade-b478-7868ad2a16ff' | ACTIVE | + | | | | ip_address='fda4:653e:71b0:0:f816:3eff:fe16:b5f2', subnet_id='43414c53-62ae-49bc-aa6c-c9dd7705818a' | | + +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+--------+ - $ neutron port-show da0b1f75-c895-460f-9fc1-4d6ec84cf85f - +-----------------------+-------------------------------------------------------------------------------------------------------------+ - | Field | Value | - +-----------------------+-------------------------------------------------------------------------------------------------------------+ - | admin_state_up | True | - | allowed_address_pairs | | - | binding:vnic_type | normal | - | device_id | 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 | - | device_owner | compute:None | - | dns_assignment | {"hostname": "my-vm", "ip_address": "192.0.2.15", "fqdn": "my-vm.example.org."} | - | | {"hostname": "my-vm", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe16:b5f2", "fqdn": "my-vm.example.org."} | - | dns_name | my-vm | - | extra_dhcp_opts | | - | fixed_ips | {"subnet_id": "5b9282a1-0be1-4ade-b478-7868ad2a16ff", "ip_address": "192.0.2.15"} | - | | {"subnet_id": "43414c53-62ae-49bc-aa6c-c9dd7705818a", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe16:b5f2"} | - | id | da0b1f75-c895-460f-9fc1-4d6ec84cf85f | - | mac_address | fa:16:3e:16:b5:f2 | - | name | | - | network_id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | - | port_security_enabled | True | - | revision_number | 1 | - | security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | - | status | ACTIVE | - | tags | [] | - | tenant_id | d5660cb1e6934612a01b4fb2fb630725 | - +-----------------------+-------------------------------------------------------------------------------------------------------------+ + $ openstack port show da0b1f75-c895-460f-9fc1-4d6ec84cf85f + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | Field | Value | + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | admin_state_up | UP | + | allowed_address_pairs | | + | binding_host_id | vultr.guest | + | binding_profile | | + | binding_vif_details | datapath_type='system', ovs_hybrid_plug='True', port_filter='True' | + | binding_vif_type | ovs | + | binding_vnic_type | normal | + | created_at | 2016-02-15T19:27:34Z | + | data_plane_status | None | + | description | | + | device_id | 43f328bb-b2d1-4cf1-a36f-3b2593397cb1 | + | device_owner | compute:None | + | dns_assignment | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='192.0.2.15' | + | | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='fda4:653e:71b0:0:f816:3eff:fe16:b5f2' | + | dns_domain | example.org. | + | dns_name | my-vm | + | extra_dhcp_opts | | + | fixed_ips | ip_address='192.0.2.15', subnet_id='5b9282a1-0be1-4ade-b478-7868ad2a16ff' | + | | ip_address='fda4:653e:71b0:0:f816:3eff:fe16:b5f2', subnet_id='43414c53-62ae-49bc-aa6c-c9dd7705818a' | + | id | da0b1f75-c895-460f-9fc1-4d6ec84cf85f | + | mac_address | fa:16:3e:16:b5:f2 | + | name | | + | network_id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | + | port_security_enabled | True | + | project_id | d5660cb1e6934612a01b4fb2fb630725 | + | qos_policy_id | None | + | revision_number | 1 | + | security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | + | status | ACTIVE | + | tags | | + | trunk_details | None | + | updated_at | 2016-02-15T19:27:34Z | + +-----------------------+------------------------------------------------------------------------------------------------------------+ $ openstack recordset list example.org. +--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+ @@ -233,24 +256,29 @@ Following is an example of these steps: | e7c05a5d-83a0-4fe5-8bd5-ab058a3326aa | example.org. | SOA | ns1.devstack.org. malavall.us.ibm.com. 1513767794 3532 600 86400 3600 | ACTIVE | NONE | +--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+ - $ neutron floatingip-create 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a \ - --port_id da0b1f75-c895-460f-9fc1-4d6ec84cf85f - Created a new floatingip: + $ openstack floating ip create 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a \ + --port da0b1f75-c895-460f-9fc1-4d6ec84cf85f +---------------------+--------------------------------------+ | Field | Value | +---------------------+--------------------------------------+ + | created_at | 2016-02-15T20:27:34Z | + | description | | | dns_domain | | | dns_name | | | fixed_ip_address | 192.0.2.15 | | floating_ip_address | 198.51.100.4 | | floating_network_id | 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a | | id | e78f6eb1-a35f-4a90-941d-87c888d5fcc7 | + | name | 198.51.100.4 | | port_id | da0b1f75-c895-460f-9fc1-4d6ec84cf85f | + | project_id | d5660cb1e6934612a01b4fb2fb630725 | + | qos_policy_id | None | | revision_number | 1 | | router_id | 970ebe83-c4a3-4642-810e-43ab7b0c2b5f | | status | DOWN | + | subnet_id | None | | tags | [] | - | tenant_id | d5660cb1e6934612a01b4fb2fb630725 | + | updated_at | 2016-02-15T20:27:34Z | +---------------------+--------------------------------------+ $ openstack recordset list example.org. @@ -295,27 +323,38 @@ allocated for the instance: .. code-block:: console - $ neutron net-show 38c5e950-b450-4c30-83d4-ee181c28aad3 - +-------------------------+--------------------------------------+ - | Field | Value | - +-------------------------+--------------------------------------+ - | admin_state_up | True | - | availability_zone_hints | | - | availability_zones | nova | - | dns_domain | example.org. | - | id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | - | mtu | 1450 | - | name | private | - | port_security_enabled | True | - | revision_number | 1 | - | router:external | False | - | shared | False | - | status | ACTIVE | - | subnets | 43414c53-62ae-49bc-aa6c-c9dd7705818a | - | | 5b9282a1-0be1-4ade-b478-7868ad2a16ff | - | tags | [] | - | tenant_id | d5660cb1e6934612a01b4fb2fb630725 | - +-------------------------+--------------------------------------+ + $ openstack network show 38c5e950-b450-4c30-83d4-ee181c28aad3 + +---------------------------+----------------------------------------------------------------------------+ + | Field | Value | + +---------------------------+----------------------------------------------------------------------------+ + | admin_state_up | UP | + | availability_zone_hints | | + | availability_zones | nova | + | created_at | 2016-05-04T19:27:34Z | + | description | | + | dns_domain | example.org. | + | id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | + | ipv4_address_scope | None | + | ipv6_address_scope | None | + | is_default | None | + | is_vlan_transparent | None | + | mtu | 1450 | + | name | private | + | port_security_enabled | True | + | project_id | d5660cb1e6934612a01b4fb2fb630725 | + | provider:network_type | vlan | + | provider:physical_network | None | + | provider:segmentation_id | 24 | + | qos_policy_id | None | + | revision_number | 1 | + | router:external | Internal | + | segments | None | + | shared | False | + | status | ACTIVE | + | subnets | 43414c53-62ae-49bc-aa6c-c9dd7705818a, 5b9282a1-0be1-4ade-b478-7868ad2a16ff | + | tags | | + | updated_at | 2016-05-04T19:27:34Z | + +---------------------------+----------------------------------------------------------------------------+ $ openstack server create --image cirros --flavor 42 \ --nic net-id=38c5e950-b450-4c30-83d4-ee181c28aad3 my_vm @@ -358,40 +397,51 @@ allocated for the instance: | 71fb4ac8-eed8-4644-8113-0641962bb125 | my_vm | ACTIVE | - | Running | private=fda4:653e:71b0:0:f816:3eff:fe24:8614, 192.0.2.16 | cirros | +--------------------------------------+-------+--------+------------+-------------+----------------------------------------------------------+------------+ - $ neutron port-list --device_id 71fb4ac8-eed8-4644-8113-0641962bb125 - +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ - | id | name | mac_address | fixed_ips | - +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ - | 1e7033fb-8e9d-458b-89ed-8312cafcfdcb | | fa:16:3e:24:86:14 | {"subnet_id": "5b9282a1-0be1-4ade-b478-7868ad2a16ff", "ip_address": "192.0.2.16"} | - | | | | {"subnet_id": "43414c53-62ae-49bc-aa6c-c9dd7705818a", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe24:8614"} | - +--------------------------------------+------+-------------------+-------------------------------------------------------------------------------------------------------------+ + $ openstack port list --device-id 71fb4ac8-eed8-4644-8113-0641962bb125 + +--------------------------------------+------+-------------------+-----------------------------------------------------------------------------------------------------+--------+ + | ID | Name | MAC Address | Fixed IP Addresses | Status | + +--------------------------------------+------+-------------------+-----------------------------------------------------------------------------------------------------+--------+ + | 1e7033fb-8e9d-458b-89ed-8312cafcfdcb | | fa:16:3e:24:86:14 | ip_address='192.0.2.16', subnet_id='5b9282a1-0be1-4ade-b478-7868ad2a16ff' | ACTIVE | + | | | | ip_address='fda4:653e:71b0:0:f816:3eff:fe24:8614', subnet_id='43414c53-62ae-49bc-aa6c-c9dd7705818a' | | + +--------------------------------------+------+-------------------+-----------------------------------------------------------------------------------------------------+--------+ - $ neutron port-show 1e7033fb-8e9d-458b-89ed-8312cafcfdcb - +-----------------------+-------------------------------------------------------------------------------------------------------------+ - | Field | Value | - +-----------------------+-------------------------------------------------------------------------------------------------------------+ - | admin_state_up | True | - | allowed_address_pairs | | - | binding:vnic_type | normal | - | device_id | 71fb4ac8-eed8-4644-8113-0641962bb125 | - | device_owner | compute:None | - | dns_assignment | {"hostname": "my-vm", "ip_address": "192.0.2.16", "fqdn": "my-vm.example.org."} | - | | {"hostname": "my-vm", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe24:8614", "fqdn": "my-vm.example.org."} | - | dns_name | my-vm | - | extra_dhcp_opts | | - | fixed_ips | {"subnet_id": "5b9282a1-0be1-4ade-b478-7868ad2a16ff", "ip_address": "192.0.2.16"} | - | | {"subnet_id": "43414c53-62ae-49bc-aa6c-c9dd7705818a", "ip_address": "fda4:653e:71b0:0:f816:3eff:fe24:8614"} | - | id | 1e7033fb-8e9d-458b-89ed-8312cafcfdcb | - | mac_address | fa:16:3e:24:86:14 | - | name | | - | network_id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | - | port_security_enabled | True | - | revision_number | 1 | - | security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | - | status | ACTIVE | - | tags | [] | - | tenant_id | d5660cb1e6934612a01b4fb2fb630725 | - +-----------------------+-------------------------------------------------------------------------------------------------------------+ + $ openstack port show 1e7033fb-8e9d-458b-89ed-8312cafcfdcb + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | Field | Value | + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | admin_state_up | UP | + | allowed_address_pairs | | + | binding_host_id | vultr.guest | + | binding_profile | | + | binding_vif_details | datapath_type='system', ovs_hybrid_plug='True', port_filter='True' | + | binding_vif_type | ovs | + | binding_vnic_type | normal | + | created_at | 2016-02-15T19:42:44Z | + | data_plane_status | None | + | description | | + | device_id | 71fb4ac8-eed8-4644-8113-0641962bb125 | + | device_owner | compute:None | + | dns_assignment | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='192.0.2.16' | + | | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='fda4:653e:71b0:0:f816:3eff:fe24:8614' | + | dns_domain | example.org. | + | dns_name | my-vm | + | extra_dhcp_opts | | + | fixed_ips | ip_address='192.0.2.16', subnet_id='5b9282a1-0be1-4ade-b478-7868ad2a16ff' | + | | ip_address='fda4:653e:71b0:0:f816:3eff:fe24:8614', subnet_id='43414c53-62ae-49bc-aa6c-c9dd7705818a' | + | id | 1e7033fb-8e9d-458b-89ed-8312cafcfdcb | + | mac_address | fa:16:3e:24:86:14 | + | name | | + | network_id | 38c5e950-b450-4c30-83d4-ee181c28aad3 | + | port_security_enabled | True | + | project_id | d5660cb1e6934612a01b4fb2fb630725 | + | qos_policy_id | None | + | revision_number | 1 | + | security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | + | status | ACTIVE | + | tags | | + | trunk_details | None | + | updated_at | 2016-02-15T19:42:44Z | + +-----------------------+------------------------------------------------------------------------------------------------------------+ $ openstack recordset list example.org. +--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+ @@ -483,46 +533,51 @@ external DNS service. This is an example: .. code-block:: console - $ neutron net-list - +--------------------------------------+----------+----------------------------------------------------------+ - | id | name | subnets | - +--------------------------------------+----------+----------------------------------------------------------+ - | 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a | public | a67cfdf7-9d5d-406f-8a19-3f38e4fc3e74 | - | | | cbd8c6dc-ca81-457e-9c5d-f8ece7ef67f8 | - | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | external | 277eca5d-9869-474b-960e-6da5951d09f7 203.0.113.0/24 | - | | | eab47748-3f0a-4775-a09f-b0c24bb64bc4 2001:db8:10::/64 | - | bf2802a0-99a0-4e8c-91e4-107d03f158ea | my-net | 6141b474-56cd-430f-b731-71660bb79b79 192.0.2.64/26 | - | 38c5e950-b450-4c30-83d4-ee181c28aad3 | private | 43414c53-62ae-49bc-aa6c-c9dd7705818a fda4:653e:71b0::/64 | - | | | 5b9282a1-0be1-4ade-b478-7868ad2a16ff 192.0.2.0/26 | - +--------------------------------------+----------+----------------------------------------------------------+ + $ openstack network list + +--------------------------------------+----------+-----------------------------------------------------------------------------+ + | ID | Name | Subnets | + +--------------------------------------+----------+-----------------------------------------------------------------------------+ + | 41fa3995-9e4a-4cd9-bb51-3e5424f2ff2a | public | a67cfdf7-9d5d-406f-8a19-3f38e4fc3e74, cbd8c6dc-ca81-457e-9c5d-f8ece7ef67f8 | + | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | external | 277eca5d-9869-474b-960e-6da5951d09f7, eab47748-3f0a-4775-a09f-b0c24bb64bc4 | + | bf2802a0-99a0-4e8c-91e4-107d03f158ea | my-net | 6141b474-56cd-430f-b731-71660bb79b79 | + | 38c5e950-b450-4c30-83d4-ee181c28aad3 | private | 43414c53-62ae-49bc-aa6c-c9dd7705818a, 5b9282a1-0be1-4ade-b478-7868ad2a16ff | + +--------------------------------------+----------+-----------------------------------------------------------------------------+ $ neutron net-update 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 --dns_domain example.org. Updated network: 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 - $ neutron net-show 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 - +---------------------------+--------------------------------------+ - | Field | Value | - +---------------------------+--------------------------------------+ - | admin_state_up | True | - | availability_zone_hints | | - | availability_zones | nova | - | dns_domain | example.org. | - | id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | - | mtu | 1450 | - | name | external | - | port_security_enabled | True | - | provider:network_type | vlan | - | provider:physical_network | | - | provider:segmentation_id | 2016 | - | revision_number | 4 | - | router:external | False | - | shared | True | - | status | ACTIVE | - | subnets | eab47748-3f0a-4775-a09f-b0c24bb64bc4 | - | | 277eca5d-9869-474b-960e-6da5951d09f7 | - | tags | [] | - | tenant_id | 04fc2f83966245dba907efb783f8eab9 | - +---------------------------+--------------------------------------+ + $ openstack network show 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 + +---------------------------+----------------------------------------------------------------------------+ + | Field | Value | + +---------------------------+----------------------------------------------------------------------------+ + | admin_state_up | UP | + | availability_zone_hints | | + | availability_zones | nova | + | created_at | 2016-02-14T19:42:44Z | + | description | | + | dns_domain | example.org. | + | id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | + | ipv4_address_scope | None | + | ipv6_address_scope | None | + | is_default | None | + | is_vlan_transparent | None | + | mtu | 1450 | + | name | external | + | port_security_enabled | True | + | project_id | 04fc2f83966245dba907efb783f8eab9 | + | provider:network_type | vlan | + | provider:physical_network | None | + | provider:segmentation_id | 2016 | + | qos_policy_id | None | + | revision_number | 4 | + | router:external | Internal | + | segments | None | + | shared | True | + | status | ACTIVE | + | subnets | eab47748-3f0a-4775-a09f-b0c24bb64bc4, 277eca5d-9869-474b-960e-6da5951d09f7 | + | tags | | + | updated_at | 2016-02-15T13:42:44Z | + +---------------------------+----------------------------------------------------------------------------+ $ openstack recordset list example.org. +--------------------------------------+--------------+------+-----------------------------------------------------------------------+--------+--------+ @@ -532,32 +587,43 @@ external DNS service. This is an example: | e7c05a5d-83a0-4fe5-8bd5-ab058a3326aa | example.org. | SOA | ns1.devstack.org. malavall.us.ibm.com. 1513767619 3532 600 86400 3600 | ACTIVE | NONE | +--------------------------------------+--------------+------+-----------------------------------------------------------------------+--------+--------+ - $ neutron port-create 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 --dns_name my-vm - Created a new port: - +-----------------------+---------------------------------------------------------------------------------------+ - | Field | Value | - +-----------------------+---------------------------------------------------------------------------------------+ - | admin_state_up | True | - | allowed_address_pairs | | - | binding:vnic_type | normal | - | device_id | | - | device_owner | | - | dns_assignment | {"hostname": "my-vm", "ip_address": "203.0.113.9", "fqdn": "my-vm.example.org."} | - | | {"hostname": "my-vm", "ip_address": "2001:db8:10::9", "fqdn": "my-vm.example.org."} | - | dns_name | my-vm | - | fixed_ips | {"subnet_id": "277eca5d-9869-474b-960e-6da5951d09f7", "ip_address": "203.0.113.9"} | - | | {"subnet_id": "eab47748-3f0a-4775-a09f-b0c24bb64bc4", "ip_address": "2001:db8:10::9"} | - | id | 04be331b-dc5e-410a-9103-9c8983aeb186 | - | mac_address | fa:16:3e:0f:4b:e4 | - | name | | - | network_id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | - | port_security_enabled | True | - | revision_number | 1 | - | security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | - | status | DOWN | - | tags | [] | - | tenant_id | d5660cb1e6934612a01b4fb2fb630725 | - +-----------------------+---------------------------------------------------------------------------------------+ + $ openstack port create --network 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 --dns-name my-vm test + +-----------------------+-------------------------------------------------------------------------------+ + | Field | Value | + +-----------------------+-------------------------------------------------------------------------------+ + | admin_state_up | UP | + | allowed_address_pairs | | + | binding_host_id | | + | binding_profile | | + | binding_vif_details | | + | binding_vif_type | unbound | + | binding_vnic_type | normal | + | created_at | 2016-02-15T16:42:44Z | + | data_plane_status | None | + | description | | + | device_id | | + | device_owner | | + | dns_assignment | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='203.0.113.9' | + | | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='2001:db8:10::9' | + | dns_domain | None | + | dns_name | my-vm | + | extra_dhcp_opts | | + | fixed_ips | ip_address='203.0.113.9', subnet_id='277eca5d-9869-474b-960e-6da5951d09f7' | + | | ip_address='2001:db8:10::9', subnet_id=‘eab47748-3f0a-4775-a09f-b0c24bb64bc4’ | + | id | 04be331b-dc5e-410a-9103-9c8983aeb186 | + | mac_address | fa:16:3e:0f:4b:e4 | + | name | test | + | network_id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | + | port_security_enabled | True | + | project_id | d5660cb1e6934612a01b4fb2fb630725 | + | qos_policy_id | None | + | revision_number | 1 | + | security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | + | status | DOWN | + | tags | | + | trunk_details | None | + | updated_at | 2016-02-15T16:42:44Z | + +-----------------------+-------------------------------------------------------------------------------+ $ openstack recordset list example.org. +--------------------------------------+--------------------+------+-----------------------------------------------------------------------+--------+--------+ diff --git a/doc/source/admin/config-dns-int.rst b/doc/source/admin/config-dns-int.rst index 0521db8418b..282e4c83726 100644 --- a/doc/source/admin/config-dns-int.rst +++ b/doc/source/admin/config-dns-int.rst @@ -93,29 +93,41 @@ in its ``dns_name`` attribute. .. code-block:: console - $ neutron port-create my-net --dns-name my-port - Created a new port: - +-----------------------+-------------------------------------------------------------------------------------+ - | Field | Value | - +-----------------------+-------------------------------------------------------------------------------------+ - | admin_state_up | True | - | allowed_address_pairs | | - | binding:vnic_type | normal | - | device_id | | - | device_owner | | - | dns_assignment | {"hostname": "my-port", "ip_address": "192.0.2.67", "fqdn": "my-port.example.org."} | - | dns_name | my-port | - | fixed_ips | {"subnet_id":"6141b474-56cd-430f-b731-71660bb79b79", "ip_address": "192.0.2.67"} | - | id | fb3c10f4-017e-420c-9be1-8f8c557ae21f | - | mac_address | fa:16:3e:aa:9b:e1 | - | name | | - | network_id | bf2802a0-99a0-4e8c-91e4-107d03f158ea | - | port_security_enabled | True | - | revision_number | 1 | - | security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | - | status | DOWN | - | tenant_id | d5660cb1e6934612a01b4fb2fb630725 | - +-----------------------+-------------------------------------------------------------------------------------+ + $ openstack port create --network my-net --dns-name my-port test + +-----------------------+-------------------------------------------------------------------------------+ + | Field | Value | + +-----------------------+-------------------------------------------------------------------------------+ + | admin_state_up | UP | + | allowed_address_pairs | | + | binding_host_id | | + | binding_profile | | + | binding_vif_details | | + | binding_vif_type | unbound | + | binding_vnic_type | normal | + | created_at | 2016-02-05T21:35:04Z | + | data_plane_status | None | + | description | | + | device_id | | + | device_owner | | + | dns_assignment | fqdn='my-port.example.org.', hostname='my-port', ip_address='192.0.2.67' | + | dns_domain | None | + | dns_name | my-port | + | extra_dhcp_opts | | + | fixed_ips | ip_address='192.0.2.67', subnet_id='6141b474-56cd-430f-b731-71660bb79b79' | + | id | fb3c10f4-017e-420c-9be1-8f8c557ae21f | + | mac_address | fa:16:3e:aa:9b:e1 | + | name | test | + | network_id | bf2802a0-99a0-4e8c-91e4-107d03f158ea | + | port_security_enabled | True | + | project_id | d5660cb1e6934612a01b4fb2fb630725 | + | qos_policy_id | None | + | revision_number | 1 | + | security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | + | status | DOWN | + | tags | | + | trunk_details | None | + | updated_at | 2016-02-05T21:35:04Z | + +-----------------------+-------------------------------------------------------------------------------+ When this functionality is enabled, it is leveraged by the Compute service when creating instances. When allocating ports for an instance during boot, the @@ -164,40 +176,51 @@ The following is an example of an instance creation, showing how its | user_id | 8bb6e578cba24e7db9d3810633124525 | +--------------------------------------+----------------------------------------------------------------+ - $ neutron port-list --device_id 66c13cb4-3002-4ab3-8400-7efc2659c363 - +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+ - | id | name | mac_address | fixed_ips | - +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+ - | b3ecc464-1263-44a7-8c38-2d8a52751773 | | fa:16:3e:a8:ce:b8 | {"subnet_id": "277eca5d-9869-474b-960e-6da5951d09f7", "ip_address": "203.0.113.8"} | - | | | | {"subnet_id": "eab47748-3f0a-4775-a09f-b0c24bb64bc4", "ip_address":"2001:db8:10::8"} | - +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+ + $ openstack port list --device-id 66c13cb4-3002-4ab3-8400-7efc2659c363 + +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+--------+ + | ID | Name | MAC Address | Fixed IP Addresses | Status | + +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+--------+ + | b3ecc464-1263-44a7-8c38-2d8a52751773 | | fa:16:3e:a8:ce:b8 | ip_address='203.0.113.8', subnet_id='277eca5d-9869-474b-960e-6da5951d09f7' | ACTIVE | + | | | | ip_address='2001:db8:10::8', subnet_id='eab47748-3f0a-4775-a09f-b0c24bb64bc4' | | + +--------------------------------------+------+-------------------+---------------------------------------------------------------------------------------+--------+ - $ neutron port-show b3ecc464-1263-44a7-8c38-2d8a52751773 - +-----------------------+---------------------------------------------------------------------------------------+ - | Field | Value | - +-----------------------+---------------------------------------------------------------------------------------+ - | admin_state_up | True | - | allowed_address_pairs | | - | binding:vnic_type | normal | - | device_id | 66c13cb4-3002-4ab3-8400-7efc2659c363 | - | device_owner | compute:None | - | dns_assignment | {"hostname": "my-vm", "ip_address": "203.0.113.8", "fqdn": "my-vm.example.org."} | - | | {"hostname": "my-vm", "ip_address": "2001:db8:10::8", "fqdn": "my-vm.example.org."} | - | dns_name | my-vm | - | extra_dhcp_opts | | - | fixed_ips | {"subnet_id": "277eca5d-9869-474b-960e-6da5951d09f7", "ip_address": "203.0.113.8"} | - | | {"subnet_id": "eab47748-3f0a-4775-a09f-b0c24bb64bc4", "ip_address": "2001:db8:10::8"} | - | id | b3ecc464-1263-44a7-8c38-2d8a52751773 | - | mac_address | fa:16:3e:a8:ce:b8 | - | name | | - | network_id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | - | port_security_enabled | True | - | revision_number | 1 | - | security_groups | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | - | status | ACTIVE | - | tags | [] | - | tenant_id | d5660cb1e6934612a01b4fb2fb630725 | - +-----------------------+---------------------------------------------------------------------------------------+ + $ openstack port show b3ecc464-1263-44a7-8c38-2d8a52751773 + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | Field | Value | + +-----------------------+------------------------------------------------------------------------------------------------------------+ + | admin_state_up | UP | + | allowed_address_pairs | | + | binding_host_id | vultr.guest | + | binding_profile | | + | binding_vif_details | datapath_type='system', ovs_hybrid_plug='True', port_filter='True' | + | binding_vif_type | ovs | + | binding_vnic_type | normal | + | created_at | 2016-02-05T21:35:04Z | + | data_plane_status | None | + | description | | + | device_id | 66c13cb4-3002-4ab3-8400-7efc2659c363 | + | device_owner | compute:None | + | dns_assignment | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='203.0.113.8' | + | | fqdn='my-vm.example.org.', hostname='my-vm', ip_address='2001:db8:10::8' | + | dns_domain | example.org. | + | dns_name | my-vm | + | extra_dhcp_opts | | + | fixed_ips | ip_address='203.0.113.8', subnet_id='277eca5d-9869-474b-960e-6da5951d09f7' | + | | ip_address='2001:db8:10::8', subnet_id='eab47748-3f0a-4775-a09f-b0c24bb64bc4' | + | id | b3ecc464-1263-44a7-8c38-2d8a52751773 | + | mac_address | fa:16:3e:a8:ce:b8 | + | name | | + | network_id | 37aaff3a-6047-45ac-bf4f-a825e56fd2b3 | + | port_security_enabled | True | + | project_id | d5660cb1e6934612a01b4fb2fb630725 | + | qos_policy_id | None | + | revision_number | 1 | + | security_group_ids | 1f0ddd73-7e3c-48bd-a64c-7ded4fe0e635 | + | status | ACTIVE | + | tags | | + | trunk_details | None | + | updated_at | 2016-02-05T21:35:04Z | + +-----------------------+------------------------------------------------------------------------------------------------------------+ In the above example notice that: diff --git a/doc/source/admin/config-dvr-ha-snat.rst b/doc/source/admin/config-dvr-ha-snat.rst index b8dd5dae5a9..e9299a11878 100644 --- a/doc/source/admin/config-dvr-ha-snat.rst +++ b/doc/source/admin/config-dvr-ha-snat.rst @@ -72,13 +72,13 @@ Controller node configuration (DVR HA). The same can explicitly be accomplished by a user with administrative - credentials setting the flags in the :command:`neutron router-create` + credentials setting the flags in the :command:`openstack router create` command: .. code-block:: console - $ neutron router-create name-of-router --distributed=True --ha=True + $ openstack router create name-of-router --distributed --ha .. note:: diff --git a/doc/source/admin/config-rbac.rst b/doc/source/admin/config-rbac.rst index f2b9473c275..69444d56f7c 100644 --- a/doc/source/admin/config-rbac.rst +++ b/doc/source/admin/config-rbac.rst @@ -259,7 +259,7 @@ command: +-------------------------------+-------------+--------------------------------+ -Use the :command:`neutron rbac-show` command to see the details: +Use the :command:`openstack network rbac show` command to see the details: .. code-block:: console diff --git a/doc/source/admin/config-service-subnets.rst b/doc/source/admin/config-service-subnets.rst index 2a405fa8d06..feaf6f795fb 100644 --- a/doc/source/admin/config-service-subnets.rst +++ b/doc/source/admin/config-service-subnets.rst @@ -258,7 +258,7 @@ This example uses again the private network, ``demo-net1`` .. code-block:: console - $ neutron router-gateway-set demo-router demo-ext-net + $ openstack router set --external-gateway demo-ext-net demo-router #. Launch an instance on a private network and retrieve the neutron port ID that was allocated. As above, use the ``cirros`` @@ -306,7 +306,7 @@ This example uses again the private network, ``demo-net1`` .. code-block:: console - $ neutron port-show f148ffeb-3c26-4067-bc5f-5c3dfddae2f5 + $ openstack port show f148ffeb-3c26-4067-bc5f-5c3dfddae2f5 +-----------------------+--------------------------------------------------------------------------+ | Field | Value | +-----------------------+--------------------------------------------------------------------------+ @@ -329,7 +329,7 @@ This example uses again the private network, ``demo-net1`` .. code-block:: console - $ neutron port-show a2d1e756-8ae1-4f96-9aa1-e7ea16a6a68a + $ openstack port show a2d1e756-8ae1-4f96-9aa1-e7ea16a6a68a +-----------------------+--------------------------------------------------------------------------+ | Field | Value | +-----------------------+--------------------------------------------------------------------------+ diff --git a/doc/source/admin/ops-resource-tags.rst b/doc/source/admin/ops-resource-tags.rst index d52f4b248fe..8a2a6cc4b84 100644 --- a/doc/source/admin/ops-resource-tags.rst +++ b/doc/source/admin/ops-resource-tags.rst @@ -112,106 +112,153 @@ Add a tag to a resource: .. code-block:: console - $ neutron tag-add --resource-type network --resource ab442634-1cc9-49e5-bd49-0dac9c811f69 --tag red - $ neutron net-show net - +-------------------------+--------------------------------------+ - | Field | Value | - +-------------------------+--------------------------------------+ - | admin_state_up | True | - | availability_zone_hints | | - | availability_zones | | - | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | - | ipv4_address_scope | | - | ipv6_address_scope | | - | mtu | 1450 | - | name | net | - | port_security_enabled | True | - | router:external | False | - | shared | False | - | status | ACTIVE | - | subnets | | - | tags | red | - | tenant_id | e6710680bfd14555891f265644e1dd5c | - +-------------------------+--------------------------------------+ + $ openstack network set --tag red ab442634-1cc9-49e5-bd49-0dac9c811f69 + $ openstack network show net + +---------------------------+----------------------------------------------------------------------------+ + | Field | Value | + +---------------------------+----------------------------------------------------------------------------+ + | admin_state_up | UP | + | availability_zone_hints | | + | availability_zones | nova | + | created_at | 2018-07-11T09:44:50Z | + | description | | + | dns_domain | None | + | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | + | ipv4_address_scope | None | + | ipv6_address_scope | None | + | is_default | None | + | is_vlan_transparent | None | + | mtu | 1450 | + | name | net | + | port_security_enabled | True | + | project_id | e6710680bfd14555891f265644e1dd5c | + | provider:network_type | vxlan | + | provider:physical_network | None | + | provider:segmentation_id | 1047 | + | qos_policy_id | None | + | revision_number | 5 | + | router:external | Internal | + | segments | None | + | shared | False | + | status | ACTIVE | + | subnets | | + | tags | red | + | updated_at | 2018-07-16T06:22:01Z | + +---------------------------+----------------------------------------------------------------------------+ Remove a tag from a resource: .. code-block:: console - $ neutron tag-remove --resource-type network --resource ab442634-1cc9-49e5-bd49-0dac9c811f69 --tag red - $ neutron net-show net - +-------------------------+--------------------------------------+ - | Field | Value | - +-------------------------+--------------------------------------+ - | admin_state_up | True | - | availability_zone_hints | | - | availability_zones | | - | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | - | ipv4_address_scope | | - | ipv6_address_scope | | - | mtu | 1450 | - | name | net | - | port_security_enabled | True | - | router:external | False | - | shared | False | - | status | ACTIVE | - | subnets | | - | tags | | - | tenant_id | e6710680bfd14555891f265644e1dd5c | - +-------------------------+--------------------------------------+ + $ openstack network unset --tag red ab442634-1cc9-49e5-bd49-0dac9c811f69 + $ openstack network show net + +---------------------------+----------------------------------------------------------------------------+ + | Field | Value | + +---------------------------+----------------------------------------------------------------------------+ + | admin_state_up | UP | + | availability_zone_hints | | + | availability_zones | nova | + | created_at | 2018-07-11T09:44:50Z | + | description | | + | dns_domain | None | + | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | + | ipv4_address_scope | None | + | ipv6_address_scope | None | + | is_default | None | + | is_vlan_transparent | None | + | mtu | 1450 | + | name | net | + | port_security_enabled | True | + | project_id | e6710680bfd14555891f265644e1dd5c | + | provider:network_type | vxlan | + | provider:physical_network | None | + | provider:segmentation_id | 1047 | + | qos_policy_id | None | + | revision_number | 5 | + | router:external | Internal | + | segments | None | + | shared | False | + | status | ACTIVE | + | subnets | | + | tags | | + | updated_at | 2018-07-16T06:32:11Z | + +---------------------------+----------------------------------------------------------------------------+ Replace all tags on the resource: .. code-block:: console - $ neutron tag-replace --resource-type network --resource ab442634-1cc9-49e5-bd49-0dac9c811f69 --tag red --tag blue - $ neutron net-show net - +-------------------------+--------------------------------------+ - | Field | Value | - +-------------------------+--------------------------------------+ - | admin_state_up | True | - | availability_zone_hints | | - | availability_zones | | - | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | - | ipv4_address_scope | | - | ipv6_address_scope | | - | mtu | 1450 | - | name | net | - | port_security_enabled | True | - | router:external | False | - | shared | False | - | status | ACTIVE | - | subnets | | - | tags | red | - | | blue | - | tenant_id | e6710680bfd14555891f265644e1dd5c | - +-------------------------+--------------------------------------+ + $ openstack network set --tag red --tag blue ab442634-1cc9-49e5-bd49-0dac9c811f69 + $ openstack network show net + +---------------------------+----------------------------------------------------------------------------+ + | Field | Value | + +---------------------------+----------------------------------------------------------------------------+ + | admin_state_up | UP | + | availability_zone_hints | | + | availability_zones | nova | + | created_at | 2018-07-11T09:44:50Z | + | description | | + | dns_domain | None | + | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | + | ipv4_address_scope | None | + | ipv6_address_scope | None | + | is_default | None | + | is_vlan_transparent | None | + | mtu | 1450 | + | name | net | + | port_security_enabled | True | + | project_id | e6710680bfd14555891f265644e1dd5c | + | provider:network_type | vxlan | + | provider:physical_network | None | + | provider:segmentation_id | 1047 | + | qos_policy_id | None | + | revision_number | 5 | + | router:external | Internal | + | segments | None | + | shared | False | + | status | ACTIVE | + | subnets | | + | tags | blue, red | + | updated_at | 2018-07-16T06:50:19Z | + +---------------------------+----------------------------------------------------------------------------+ Clear tags from a resource: .. code-block:: console - $ neutron tag-remove --resource-type network --resource ab442634-1cc9-49e5-bd49-0dac9c811f69 --all - $ neutron net-show net - +-------------------------+--------------------------------------+ - | Field | Value | - +-------------------------+--------------------------------------+ - | admin_state_up | True | - | availability_zone_hints | | - | availability_zones | | - | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | - | ipv4_address_scope | | - | ipv6_address_scope | | - | mtu | 1450 | - | name | net | - | port_security_enabled | True | - | router:external | False | - | shared | False | - | status | ACTIVE | - | subnets | | - | tags | | - | tenant_id | e6710680bfd14555891f265644e1dd5c | - +-------------------------+--------------------------------------+ + $ openstack network unset --all-tag ab442634-1cc9-49e5-bd49-0dac9c811f69 + $ openstack network show net + +---------------------------+----------------------------------------------------------------------------+ + | Field | Value | + +---------------------------+----------------------------------------------------------------------------+ + | admin_state_up | UP | + | availability_zone_hints | | + | availability_zones | nova | + | created_at | 2018-07-11T09:44:50Z | + | description | | + | dns_domain | None | + | id | ab442634-1cc9-49e5-bd49-0dac9c811f69 | + | ipv4_address_scope | None | + | ipv6_address_scope | None | + | is_default | None | + | is_vlan_transparent | None | + | mtu | 1450 | + | name | net | + | port_security_enabled | True | + | project_id | e6710680bfd14555891f265644e1dd5c | + | provider:network_type | vxlan | + | provider:physical_network | None | + | provider:segmentation_id | 1047 | + | qos_policy_id | None | + | revision_number | 5 | + | router:external | Internal | + | segments | None | + | shared | False | + | status | ACTIVE | + | subnets | | + | tags | | + | updated_at | 2018-07-16T07:03:02Z | + +---------------------------+----------------------------------------------------------------------------+ Get list of resources with tag filters from networks. The networks are: test-net1 with "red" tag, test-net2 with "red" and "blue" tags, test-net3 with @@ -221,21 +268,21 @@ Get list of resources with ``tags`` filter: .. code-block:: console - $ neutron net-list --tags red,blue + $ openstack network list --tags red,blue +--------------------------------------+-----------+---------+ - | id | name | subnets | + | ID | Name | Subnets | +--------------------------------------+-----------+---------+ | 8ca3b9ed-f578-45fa-8c44-c53f13aec05a | test-net3 | | | e736e63d-42e4-4f4c-836c-6ad286ffd68a | test-net2 | | +--------------------------------------+-----------+---------+ -Get list of resources with ``tags-any`` filter: +Get list of resources with ``any-tags`` filter: .. code-block:: console - $ neutron net-list --tags-any red,blue + $ openstack network list --any-tags red,blue +--------------------------------------+-----------+---------+ - | id | name | subnets | + | ID | Name | Subnets | +--------------------------------------+-----------+---------+ | 30491224-3855-431f-a688-fb29df004d82 | test-net1 | | | 8ca3b9ed-f578-45fa-8c44-c53f13aec05a | test-net3 | | @@ -246,21 +293,21 @@ Get list of resources with ``not-tags`` filter: .. code-block:: console - $ neutron net-list --not-tags red,blue + $ openstack network list --not-tags red,blue +--------------------------------------+-----------+---------+ - | id | name | subnets | + | ID | Name | Subnets | +--------------------------------------+-----------+---------+ | 30491224-3855-431f-a688-fb29df004d82 | test-net1 | | | cdb3ed08-ca63-4090-ba12-30b366372993 | test-net4 | | +--------------------------------------+-----------+---------+ -Get list of resources with ``not-tags-any`` filter: +Get list of resources with ``not-any-tags`` filter: .. code-block:: console - $ neutron net-list --not-tags-any red,blue + $ openstack network list --not-any-tags red,blue +--------------------------------------+-----------+---------+ - | id | name | subnets | + | ID | Name | Subnets | +--------------------------------------+-----------+---------+ | cdb3ed08-ca63-4090-ba12-30b366372993 | test-net4 | | +--------------------------------------+-----------+---------+ diff --git a/doc/source/admin/shared/deploy-ha-vrrp-initialnetworks.txt b/doc/source/admin/shared/deploy-ha-vrrp-initialnetworks.txt index 9d4298b53aa..6c853f1d359 100644 --- a/doc/source/admin/shared/deploy-ha-vrrp-initialnetworks.txt +++ b/doc/source/admin/shared/deploy-ha-vrrp-initialnetworks.txt @@ -92,5 +92,4 @@ on that router. .. code-block:: console - $ neutron router-gateway-set router2 provider1 - Set gateway for router router2 + $ openstack router set --external-gateway provider1 router2 diff --git a/doc/source/admin/shared/deploy-selfservice-initialnetworks.txt b/doc/source/admin/shared/deploy-selfservice-initialnetworks.txt index 68ea6f49af9..022bfca3920 100644 --- a/doc/source/admin/shared/deploy-selfservice-initialnetworks.txt +++ b/doc/source/admin/shared/deploy-selfservice-initialnetworks.txt @@ -105,5 +105,4 @@ NAT for IPv4 network traffic and directly routes IPv6 network traffic. .. code-block:: console - $ neutron router-gateway-set router1 provider1 - Set gateway for router router1 + $ openstack router set --external-gateway provider1 router1