openstack/openstack-manuals
Code Issues Proposed changes

Fix prompt usage in admin-guide-cloud

Browse Source 
Use # for root and $ for-non root commands.
Also fixes some screen markup.

Change-Id: I026bd3b4b1fffa1829210fe53112dfd0f122a60c
This commit is contained in:
Andreas Jaeger 2014-03-13 20:01:21 +01:00
parent 5c235f5f16
commit a126bd69cd
5 changed files with 100 additions and 105 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/admin-guide-cloud/ch_compute.xml
View File

@ -466,7 +466,7 @@
xlink:href="http://docs.openstack.org/user-guide/content/index.html"> xlink:href="http://docs.openstack.org/user-guide/content/index.html">
<citetitle>OpenStack End User <citetitle>OpenStack End User
Guide</citetitle></link>.</para> Guide</citetitle></link>.</para>
<screen><prompt>#</prompt> <userinput>nova --debug list</userinput> <screen><prompt>$</prompt> <userinput>nova --debug list</userinput>
<?db-font-size 75%?><computeroutput>connect: (10.0.0.15, 5000) <?db-font-size 75%?><computeroutput>connect: (10.0.0.15, 5000)
send: 'POST /v2.0/tokens HTTP/1.1\r\nHost: 10.0.0.15:5000\r\nContent-Length: 116\r\ncontent-type: application/json\r\naccept-encoding: gzip, deflate\r\naccept: application/json\r\nuser-agent: python-novaclient\r\n\r\n{"auth": {"tenantName": "demoproject", "passwordCredentials": {"username": "demouser", "password": "demopassword"}}}' send: 'POST /v2.0/tokens HTTP/1.1\r\nHost: 10.0.0.15:5000\r\nContent-Length: 116\r\ncontent-type: application/json\r\naccept-encoding: gzip, deflate\r\naccept: application/json\r\nuser-agent: python-novaclient\r\n\r\n{"auth": {"tenantName": "demoproject", "passwordCredentials": {"username": "demouser", "password": "demopassword"}}}'
reply: 'HTTP/1.1 200 OK\r\n' reply: 'HTTP/1.1 200 OK\r\n'
@ -1327,13 +1327,13 @@ echo 'Extra user data here'</computeroutput></screen>
<programlisting language="ini">net.ipv4.ip_forward = 1</programlisting> <programlisting language="ini">net.ipv4.ip_forward = 1</programlisting>
<para>Save the file and run this command to apply the <para>Save the file and run this command to apply the
changes:</para> changes:</para>
<screen><prompt>$</prompt> <userinput>sysctl -p</userinput></screen> <screen><prompt>#</prompt> <userinput>sysctl -p</userinput></screen>
<para>You can also update the setting by restarting <para>You can also update the setting by restarting
the network service.</para> the network service.</para>
<para>For example, on Ubuntu, run this command:</para> <para>For example, on Ubuntu, run this command:</para>
<screen><userinput><prompt>$</prompt>/etc/init.d/procps.sh restart</userinput></screen> <screen><userinput><prompt>#</prompt>/etc/init.d/procps.sh restart</userinput></screen>
<para>On RHEL/Fedora/CentOS, run this command:</para> <para>On RHEL/Fedora/CentOS, run this command:</para>
<screen><prompt>$</prompt> <userinput>service network restart</userinput></screen> <screen><prompt>#</prompt> <userinput>service network restart</userinput></screen>
</section> </section>
<section xml:id="create_list_of_available_floating_ips"> <section xml:id="create_list_of_available_floating_ips">
<title>Create a list of available floating IP <title>Create a list of available floating IP
@ -1343,28 +1343,23 @@ echo 'Extra user data here'</computeroutput></screen>
<command>nova-manage floating create</command> <command>nova-manage floating create</command>
command to add entries to this list.</para> command to add entries to this list.</para>
<para>For example:</para> <para>For example:</para>
<screen><prompt>$</prompt> <userinput>nova-manage floating create --pool=nova --ip_range=68.99.26.170/31</userinput></screen> <screen><prompt>#</prompt> <userinput>nova-manage floating create --pool=nova --ip_range=68.99.26.170/31</userinput></screen>
<para>You can use the following <para>You can use the following
<command>nova-manage</command> commands to <command>nova-manage</command> commands to
perform floating IP operations:</para> perform floating IP operations:</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<screen><userinput>nova-manage floating list</userinput></screen> <screen><prompt>#</prompt> <userinput>nova-manage floating list</userinput></screen>
<para>Lists the floating IP addresses in the <para>Lists the floating IP addresses in the
pool.</para> pool.</para>
</listitem> </listitem>
<listitem> <listitem>
<screen><userinput>nova-manage floating create <screen><prompt>#</prompt> <userinput>nova-manage floating create --pool=<replaceable>[pool name]</replaceable> --ip_range=<replaceable>[CIDR]</replaceable></userinput></screen>
--pool=<replaceable>[pool
name]</replaceable>
--ip_range=<replaceable>[CIDR]</replaceable>
</userinput></screen>
<para>Creates specific floating IPs for either <para>Creates specific floating IPs for either
a single address or a subnet.</para> a single address or a subnet.</para>
</listitem> </listitem>
<listitem> <listitem>
<screen><userinput>nova-manage floating delete <screen><prompt>#</prompt> <userinput>nova-manage floating delete <replaceable>[CIDR]</replaceable></userinput></screen>
<replaceable>[CIDR]</replaceable></userinput></screen>
<para>Removes floating IP addresses using the <para>Removes floating IP addresses using the
same parameters as the create same parameters as the create
command.</para> command.</para>
@ -1404,7 +1399,7 @@ echo 'Extra user data here'</computeroutput></screen>
rights. You can disassociate the project from the rights. You can disassociate the project from the
network with a scrub command and the project ID as the network with a scrub command and the project ID as the
final parameter:</para> final parameter:</para>
<screen><prompt>$</prompt> <userinput>nova-manage project scrub --project=<replaceable>&lt;id></replaceable></userinput> </screen> <screen><prompt>#</prompt> <userinput>nova-manage project scrub --project=<replaceable>&lt;id></replaceable></userinput></screen>
</section> </section>
<section xml:id="section_use-multi-nics"> <section xml:id="section_use-multi-nics">
<title>Multiple interfaces for your instances <title>Multiple interfaces for your instances
@ -1942,23 +1937,23 @@ net.bridge.bridge-nf-call-ip6tables=0</programlisting>
<step> <step>
<para>For administrators, the standard pattern for <para>For administrators, the standard pattern for
executing a nova-manage command is:</para> executing a nova-manage command is:</para>
<screen><prompt>$</prompt> <userinput>nova-manage category command <replaceable>[args]</replaceable></userinput></screen> <screen><prompt>#</prompt> <userinput>nova-manage category command <replaceable>[args]</replaceable></userinput></screen>
</step> </step>
<step> <step>
<para>For example, to obtain a list of all <para>For example, to obtain a list of all
projects:</para> projects:</para>
<screen><prompt>$</prompt> <userinput>nova-manage project list</userinput></screen> <screen><prompt>#</prompt> <userinput>nova-manage project list</userinput></screen>
</step> </step>
<step> <step>
<para>Run without arguments to see a list of <para>Run without arguments to see a list of
available command categories:</para> available command categories:</para>
<screen><prompt>$</prompt> <userinput>nova-manage</userinput></screen> <screen><prompt>#</prompt> <userinput>nova-manage</userinput></screen>
</step> </step>
<step> <step>
<para>You can also run with a category argument <para>You can also run with a category argument
such as user to see a list of all commands in such as user to see a list of all commands in
that category:</para> that category:</para>
<screen><prompt>$</prompt> <userinput>nova-manage service</userinput></screen> <screen><prompt>#</prompt> <userinput>nova-manage service</userinput></screen>
</step> </step>
</procedure> </procedure>
<simplesect> <simplesect>
@ -2113,7 +2108,7 @@ local0.error @@172.20.1.43:1024</programlisting>
<step> <step>
<para>Look at the running instances, to get the ID <para>Look at the running instances, to get the ID
of the instance you wish to migrate.</para> of the instance you wish to migrate.</para>
<screen><prompt>#</prompt> <userinput>nova list</userinput> <screen><prompt>$</prompt> <userinput>nova list</userinput>
<computeroutput><![CDATA[+--------------------------------------+------+--------+-----------------+ <computeroutput><![CDATA[+--------------------------------------+------+--------+-----------------+
| ID | Name | Status |Networks | | ID | Name | Status |Networks |
+--------------------------------------+------+--------+-----------------+ +--------------------------------------+------+--------+-----------------+
@ -2125,7 +2120,7 @@ local0.error @@172.20.1.43:1024</programlisting>
<para>Look at information associated with that <para>Look at information associated with that
instance - our example is vm1 from instance - our example is vm1 from
above.</para> above.</para>
<screen><prompt>#</prompt> <userinput>nova show d1df1b5a-70c4-4fed-98b7-423362f2c47c</userinput> <screen><prompt>$</prompt> <userinput>nova show d1df1b5a-70c4-4fed-98b7-423362f2c47c</userinput>
<computeroutput><![CDATA[+-------------------------------------+----------------------------------------------------------+ <computeroutput><![CDATA[+-------------------------------------+----------------------------------------------------------+
| Property | Value | | Property | Value |
+-------------------------------------+----------------------------------------------------------+ +-------------------------------------+----------------------------------------------------------+
@ -2209,7 +2204,7 @@ HostC p2 5 10240 150
<para>Use the <command>nova <para>Use the <command>nova
live-migration</command> command to live-migration</command> command to
migrate the instances.</para> migrate the instances.</para>
<screen><prompt>#</prompt> <userinput>nova live-migration d1df1b5a-70c4-4fed-98b7-423362f2c47c HostC</userinput><computeroutput><![CDATA[Migration of d1df1b5a-70c4-4fed-98b7-423362f2c47c initiated.]]></computeroutput></screen> <screen><prompt>$</prompt> <userinput>nova live-migration d1df1b5a-70c4-4fed-98b7-423362f2c47c HostC</userinput><computeroutput><![CDATA[Migration of d1df1b5a-70c4-4fed-98b7-423362f2c47c initiated.]]></computeroutput></screen>
<para>Make sure instances are migrated <para>Make sure instances are migrated
successfully with <command>nova successfully with <command>nova
list</command>. If instances are still running list</command>. If instances are still running
@ -2722,7 +2717,7 @@ done &lt; $volumes_tmp_file</programlisting>
<step> <step>
<para>In this example, the iscsi session is <para>In this example, the iscsi session is
number 15 for that instance:</para> number 15 for that instance:</para>
<screen><prompt>$</prompt> <userinput>iscsiadm -m session -u -r 15</userinput></screen> <screen><prompt>#</prompt> <userinput>iscsiadm -m session -u -r 15</userinput></screen>
</step> </step>
<step> <step>
<para>Do not forget the <literal>-r</literal> <para>Do not forget the <literal>-r</literal>

8
doc/admin-guide-cloud/section_backup-block-storage-disks.xml
View File

@ -55,12 +55,12 @@
<substeps> <substeps>
<step> <step>
<para>Use this command to list all volumes:</para> <para>Use this command to list all volumes:</para>
<screen><prompt>$</prompt> <userinput>lvdisplay</userinput></screen> <screen><prompt>#</prompt> <userinput>lvdisplay</userinput></screen>
</step> </step>
<step> <step>
<para>Create the snapshot; you can do this while <para>Create the snapshot; you can do this while
the volume is attached to an instance:</para> the volume is attached to an instance:</para>
<screen><prompt>$</prompt> <userinput>lvcreate --size 10G --snapshot --name volume-00000001-snapshot /dev/cinder-volumes/volume-00000001</userinput></screen> <screen><prompt>#</prompt> <userinput>lvcreate --size 10G --snapshot --name volume-00000001-snapshot /dev/cinder-volumes/volume-00000001</userinput></screen>
<para>Use the <option>--snapshot</option> <para>Use the <option>--snapshot</option>
configuration option to tell LVM that you want configuration option to tell LVM that you want
a snapshot of an already existing volume. The a snapshot of an already existing volume. The
@ -136,7 +136,7 @@ Block device 251:14</programlisting>
partitions created inside instances, you partitions created inside instances, you
cannot see its content and create efficient cannot see its content and create efficient
backups.</para> backups.</para>
<screen><prompt>$</prompt> <userinput>kpartx -av /dev/cinder-volumes/volume-00000001-snapshot</userinput></screen> <screen><prompt>#</prompt> <userinput>kpartx -av /dev/cinder-volumes/volume-00000001-snapshot</userinput></screen>
<note os="debian"> <note os="debian">
<para>On a Debian-based distribution, you can <para>On a Debian-based distribution, you can
use the <command>apt-get install kpartx</command> use the <command>apt-get install kpartx</command>
@ -163,7 +163,7 @@ Block device 251:14</programlisting>
</step> </step>
<step> <step>
<para>Mount your partition:</para> <para>Mount your partition:</para>
<screen><prompt>$</prompt> <userinput>mount /dev/mapper/cinder--volumes-volume--volume--00000001--snapshot1 /mnt</userinput></screen> <screen><prompt>#</prompt> <userinput>mount /dev/mapper/cinder--volumes-volume--volume--00000001--snapshot1 /mnt</userinput></screen>
<para>If the partition mounts successfully, no <para>If the partition mounts successfully, no
errors are returned.</para> errors are returned.</para>
<para>You can directly access the data inside the <para>You can directly access the data inside the

6
doc/admin-guide-cloud/section_compute-configure-migrations.xml
View File

@ -181,8 +181,8 @@
to the appropriate value to include the IP addresses of to the appropriate value to include the IP addresses of
<literal>HostB</literal> and <literal>HostC</literal>. <literal>HostB</literal> and <literal>HostC</literal>.
Then restart the NFS server:</para> Then restart the NFS server:</para>
<screen><prompt>$</prompt> <userinput>/etc/init.d/nfs-kernel-server restart</userinput> <screen><prompt>#</prompt> <userinput>/etc/init.d/nfs-kernel-server restart</userinput>
<prompt>$</prompt> <userinput>/etc/init.d/idmapd restart</userinput></screen> <prompt>#</prompt> <userinput>/etc/init.d/idmapd restart</userinput></screen>
</step> </step>
<step> <step>
<para>Set the 'execute/search' bit on your shared <para>Set the 'execute/search' bit on your shared
@ -235,7 +235,7 @@ HostA: 921515008 101921792 772783104 12% /var/lib/nova/instances ( &lt;
</para> </para>
<para>Restart libvirt. After you run the command, ensure that <para>Restart libvirt. After you run the command, ensure that
libvirt is successfully restarted:</para> libvirt is successfully restarted:</para>
<screen><prompt>$</prompt> <userinput>stop libvirt-bin &amp;&amp; start libvirt-bin</userinput> <screen><prompt>#</prompt> <userinput>stop libvirt-bin &amp;&amp; start libvirt-bin</userinput>
<prompt>$</prompt> <userinput>ps -ef | grep libvirt</userinput></screen> <prompt>$</prompt> <userinput>ps -ef | grep libvirt</userinput></screen>
<screen><computeroutput>root 1145 1 0 Nov27 ? 00:00:03 /usr/sbin/libvirtd -d -l</computeroutput></screen> <screen><computeroutput>root 1145 1 0 Nov27 ? 00:00:03 /usr/sbin/libvirtd -d -l</computeroutput></screen>
</step> </step>

46
doc/admin-guide-cloud/section_networking-use.xml
View File

@ -457,14 +457,14 @@
of tenants by specifying an Identity of tenants by specifying an Identity
<option>tenant_id</option> in the command, as <option>tenant_id</option> in the command, as
follows:</para> follows:</para>
<screen><prompt>#</prompt> <userinput>neutron net-create --tenant-id=<replaceable>tenant-id</replaceable> <replaceable>network-name</replaceable></userinput></screen> <screen><prompt>$</prompt> <userinput>neutron net-create --tenant-id=<replaceable>tenant-id</replaceable> <replaceable>network-name</replaceable></userinput></screen>
<para>For example:</para> <para>For example:</para>
<screen><prompt>#</prompt> <userinput>neutron net-create --tenant-id=5e4bbe24b67a4410bc4d9fae29ec394e net1</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron net-create --tenant-id=5e4bbe24b67a4410bc4d9fae29ec394e net1</userinput></screen>
<note> <note>
<para>To view all tenant IDs in Identity, run the <para>To view all tenant IDs in Identity, run the
following command as an Identity Service admin following command as an Identity Service admin
user:</para> user:</para>
<screen><prompt>#</prompt> <userinput>keystone tenant-list</userinput></screen> <screen><prompt>$</prompt> <userinput>keystone tenant-list</userinput></screen>
</note> </note>
</section> </section>
<?hard-pagebreak?> <?hard-pagebreak?>
@ -487,37 +487,37 @@
<tr> <tr>
<td>Creates a network that all tenants can <td>Creates a network that all tenants can
use.</td> use.</td>
<td><screen><prompt>#</prompt> <userinput>neutron net-create --shared public-net</userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron net-create --shared public-net</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Creates a subnet with a specified <td>Creates a subnet with a specified
gateway IP address.</td> gateway IP address.</td>
<td><screen><prompt>#</prompt> <userinput>neutron subnet-create --gateway 10.0.0.254 net1 10.0.0.0/24</userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron subnet-create --gateway 10.0.0.254 net1 10.0.0.0/24</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Creates a subnet that has no gateway <td>Creates a subnet that has no gateway
IP address.</td> IP address.</td>
<td><screen><prompt>#</prompt> <userinput>neutron subnet-create --no-gateway net1 10.0.0.0/24</userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron subnet-create --no-gateway net1 10.0.0.0/24</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Creates a subnet with DHCP <td>Creates a subnet with DHCP
disabled.</td> disabled.</td>
<td><screen><prompt>#</prompt> <userinput>neutron subnet-create net1 10.0.0.0/24 --enable_dhcp False</userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron subnet-create net1 10.0.0.0/24 --enable_dhcp False</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Creates a subnet with a specified set <td>Creates a subnet with a specified set
of host routes.</td> of host routes.</td>
<td><screen><prompt>#</prompt> <userinput>neutron subnet-create test-net1 40.0.0.0/24 --host_routes type=dict list=true destination=40.0.1.0/24,nexthop=40.0.0.2</userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron subnet-create test-net1 40.0.0.0/24 --host_routes type=dict list=true destination=40.0.1.0/24,nexthop=40.0.0.2</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Creates a subnet with a specified set <td>Creates a subnet with a specified set
of dns name servers.</td> of dns name servers.</td>
<td><screen><prompt>#</prompt> <userinput>neutron subnet-create test-net1 40.0.0.0/24 --dns_nameservers list=true 8.8.8.7 8.8.8.8</userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron subnet-create test-net1 40.0.0.0/24 --dns_nameservers list=true 8.8.8.7 8.8.8.8</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Displays all ports and IPs allocated <td>Displays all ports and IPs allocated
on a network.</td> on a network.</td>
<td><screen><prompt>#</prompt> <userinput>neutron port-list --network_id <replaceable>net-id</replaceable></userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron port-list --network_id <replaceable>net-id</replaceable></userinput></screen></td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -545,12 +545,12 @@
<tbody> <tbody>
<tr> <tr>
<td>Checks available networks.</td> <td>Checks available networks.</td>
<td><screen><prompt>#</prompt> <userinput>neutron net-list</userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron net-list</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Boots a VM with a single NIC on a <td>Boots a VM with a single NIC on a
selected Networking network.</td> selected Networking network.</td>
<td><screen><prompt>#</prompt> <userinput>nova boot --image <replaceable>img</replaceable> --flavor <replaceable>flavor</replaceable> --nic net-id=<replaceable>net-id</replaceable> <replaceable>vm-name</replaceable></userinput></screen> <td><screen><prompt>$</prompt> <userinput>nova boot --image <replaceable>img</replaceable> --flavor <replaceable>flavor</replaceable> --nic net-id=<replaceable>net-id</replaceable> <replaceable>vm-name</replaceable></userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -561,17 +561,17 @@
linkend="network_compute_note" linkend="network_compute_note"
/>.</para> />.</para>
</td> </td>
<td><screen><prompt>#</prompt> <userinput>neutron port-list --device_id=<replaceable>vm-id</replaceable></userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron port-list --device_id=<replaceable>vm-id</replaceable></userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Searches for ports, but shows only the <td>Searches for ports, but shows only the
<option>mac_address</option> of the port.</td> <option>mac_address</option> of the port.</td>
<td><screen><prompt>#</prompt> <userinput>neutron port-list --field mac_address --device_id=<replaceable>vm-id</replaceable></userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron port-list --field mac_address --device_id=<replaceable>vm-id</replaceable></userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Temporarily disables a port from <td>Temporarily disables a port from
sending traffic.</td> sending traffic.</td>
<td><screen><prompt>#</prompt> <userinput>neutron port-update <replaceable>port-id</replaceable> --admin_state_up=False</userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>neutron port-update <replaceable>port-id</replaceable> --admin_state_up=False</userinput></screen></td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
@ -618,7 +618,7 @@
<tbody> <tbody>
<tr> <tr>
<td>Boots a VM with multiple NICs.</td> <td>Boots a VM with multiple NICs.</td>
<td><screen><prompt>#</prompt> <userinput>nova boot --image <replaceable>img</replaceable> --flavor <replaceable>flavor</replaceable> --nic net-id=<replaceable>net1-id</replaceable> --nic net-id=<replaceable>net2-id</replaceable> <replaceable>vm-name</replaceable></userinput></screen></td> <td><screen><prompt>$</prompt> <userinput>nova boot --image <replaceable>img</replaceable> --flavor <replaceable>flavor</replaceable> --nic net-id=<replaceable>net1-id</replaceable> --nic net-id=<replaceable>net2-id</replaceable> <replaceable>vm-name</replaceable></userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td>Boots a VM with a specific IP address. <td>Boots a VM with a specific IP address.
@ -627,8 +627,8 @@
specifying a <option>port-id</option> specifying a <option>port-id</option>
rather than a rather than a
<option>net-id</option>.</td> <option>net-id</option>.</td>
<td><screen><prompt>#</prompt> <userinput>neutron port-create --fixed-ip subnet_id=<replaceable>subnet-id</replaceable>,ip_address=<replaceable>IP</replaceable> <replaceable>net-id</replaceable></userinput> <td><screen><prompt>$</prompt> <userinput>neutron port-create --fixed-ip subnet_id=<replaceable>subnet-id</replaceable>,ip_address=<replaceable>IP</replaceable> <replaceable>net-id</replaceable></userinput>
<prompt>#</prompt> <userinput>nova boot --image <replaceable>img</replaceable> --flavor <replaceable>flavor</replaceable> --nic port-id=<replaceable>port-id</replaceable> <replaceable>vm-name</replaceable></userinput></screen> <prompt>$</prompt> <userinput>nova boot --image <replaceable>img</replaceable> --flavor <replaceable>flavor</replaceable> --nic port-id=<replaceable>port-id</replaceable> <replaceable>vm-name</replaceable></userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -637,7 +637,7 @@
tenant who submits the request tenant who submits the request
(without the <parameter>--nic</parameter> (without the <parameter>--nic</parameter>
option).</td> option).</td>
<td><screen><prompt>#</prompt> <userinput>nova boot --image <replaceable>img</replaceable> --flavor <replaceable>flavor</replaceable> <replaceable>vm-name</replaceable></userinput></screen> <td><screen><prompt>$</prompt> <userinput>nova boot --image <replaceable>img</replaceable> --flavor <replaceable>flavor</replaceable> <replaceable>vm-name</replaceable></userinput></screen>
</td> </td>
</tr> </tr>
</tbody> </tbody>
@ -665,9 +665,9 @@
<command>ping</command> and <command>ping</command> and
<command>ssh</command> access to your <command>ssh</command> access to your
VMs.</para> VMs.</para>
<screen><prompt>#</prompt> <userinput>neutron security-group-rule-create --protocol icmp \ <screen><prompt>$</prompt> <userinput>neutron security-group-rule-create --protocol icmp \
--direction ingress default</userinput></screen> --direction ingress default</userinput></screen>
<screen><prompt>#</prompt> <userinput>neutron security-group-rule-create --protocol tcp --port-range-min 22 \ <screen><prompt>$</prompt> <userinput>neutron security-group-rule-create --protocol tcp --port-range-min 22 \
--port-range-max 22 --direction ingress default</userinput></screen> --port-range-max 22 --direction ingress default</userinput></screen>
</listitem> </listitem>
<listitem> <listitem>
@ -680,8 +680,8 @@
commands enable <command>ping</command> commands enable <command>ping</command>
and <command>ssh</command> access to your and <command>ssh</command> access to your
VMs.</para> VMs.</para>
<screen><prompt>#</prompt> <userinput>nova secgroup-add-rule default icmp -1 -1 0.0.0.0/0</userinput> <screen><prompt>$</prompt> <userinput>nova secgroup-add-rule default icmp -1 -1 0.0.0.0/0</userinput>
<prompt>#</prompt> <userinput>nova secgroup-add-rule default tcp 22 22 0.0.0.0/0</userinput></screen> <prompt>$</prompt> <userinput>nova secgroup-add-rule default tcp 22 22 0.0.0.0/0</userinput></screen>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<note> <note>

106
doc/admin-guide-cloud/section_networking_adv_features.xml
View File

@ -522,14 +522,14 @@
networks.</para></td> networks.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron net-create public --router:external=True</userinput> <screen><prompt>#</prompt> <userinput>neutron net-create public --router:external=True</userinput>
<prompt>#</prompt> <userinput>neutron subnet-create public 172.16.1.0/24</userinput></screen> <prompt>$</prompt> <userinput>neutron subnet-create public 172.16.1.0/24</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Lists external networks.</para></td> <para>Lists external networks.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron net-list -- --router:external=True</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron net-list -- --router:external=True</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -537,13 +537,13 @@
connects to multiple L2 networks connects to multiple L2 networks
privately.</para></td> privately.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron net-create net1</userinput> <screen><prompt>$</prompt> <userinput>neutron net-create net1</userinput>
<prompt>#</prompt> <userinput>neutron subnet-create net1 10.0.0.0/24</userinput> <prompt>$</prompt> <userinput>neutron subnet-create net1 10.0.0.0/24</userinput>
<prompt>#</prompt> <userinput>neutron net-create net2</userinput> <prompt>$</prompt> <userinput>neutron net-create net2</userinput>
<prompt>#</prompt> <userinput>neutron subnet-create net2 10.0.1.0/24</userinput> <prompt>$</prompt> <userinput>neutron subnet-create net2 10.0.1.0/24</userinput>
<prompt>#</prompt> <userinput>neutron router-create router1</userinput> <prompt>$</prompt> <userinput>neutron router-create router1</userinput>
<prompt>#</prompt> <userinput>neutron router-interface-add router1 &lt;subnet1-uuid&gt;</userinput> <prompt>$</prompt> <userinput>neutron router-interface-add router1 &lt;subnet1-uuid&gt;</userinput>
<prompt>#</prompt> <userinput>neutron router-interface-add router1 &lt;subnet2-uuid&gt;</userinput></screen> <prompt>$</prompt> <userinput>neutron router-interface-add router1 &lt;subnet2-uuid&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -553,7 +553,7 @@
act as a NAT gateway for external act as a NAT gateway for external
connectivity.</para></td> connectivity.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron router-gateway-set router1 &lt;ext-net-id&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron router-gateway-set router1 &lt;ext-net-id&gt;</userinput></screen>
<para>The router obtains an interface with <para>The router obtains an interface with
the gateway_ip address of the subnet, the gateway_ip address of the subnet,
and this interface is attached to a and this interface is attached to a
@ -573,7 +573,7 @@
<td> <td>
<para>Lists routers.</para></td> <para>Lists routers.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron router-list</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron router-list</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -581,7 +581,7 @@
<para>Shows information for a specified <para>Shows information for a specified
router.</para></td> router.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron router-show &lt;router_id&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron router-show &lt;router_id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -597,11 +597,11 @@
represents the VM NIC to which the represents the VM NIC to which the
floating IP should map.</para></td> floating IP should map.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron port-list -c id -c fixed_ips -- --device_id=&lt;instance_id&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron port-list -c id -c fixed_ips -- --device_id=&lt;instance_id&gt;</userinput></screen>
<para>This port must be on an Networking <para>This port must be on an Networking
subnet that is attached to a router subnet that is attached to a router
uplinked to the external network used uplinked to the external network used
to create the floating IP.  to create the floating IP.
Conceptually, this is because the Conceptually, this is because the
router must be able to perform the router must be able to perform the
Destination NAT (DNAT) rewriting of Destination NAT (DNAT) rewriting of
@ -617,8 +617,8 @@
<para>Creates a floating IP address and <para>Creates a floating IP address and
associates it with a port.</para></td> associates it with a port.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron floatingip-create &lt;ext-net-id&gt;</userinput> <screen><prompt>$</prompt> <userinput>neutron floatingip-create &lt;ext-net-id&gt;</userinput>
<prompt>#</prompt> <userinput>neutron floatingip-associate &lt;floatingip-id&gt; &lt;internal VM port-id&gt;</userinput></screen> <prompt>$</prompt> <userinput>neutron floatingip-associate &lt;floatingip-id&gt; &lt;internal VM port-id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -627,14 +627,14 @@
associates it with a port, in a single associates it with a port, in a single
step.</para></td> step.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron floatingip-create --port_id &lt;internal VM port-id&gt; &lt;ext-net-id&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron floatingip-create --port_id &lt;internal VM port-id&gt; &lt;ext-net-id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Lists floating IPs.</para></td> <para>Lists floating IPs.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron floatingip-list</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron floatingip-list</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -642,7 +642,7 @@
<para>Finds floating IP for a specified VM <para>Finds floating IP for a specified VM
port.</para></td> port.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron floatingip-list -- --port_id=ZZZ</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron floatingip-list -- --port_id=ZZZ</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -650,7 +650,7 @@
<para>Disassociates a floating IP <para>Disassociates a floating IP
address.</para></td> address.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron floatingip-disassociate &lt;floatingip-id&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron floatingip-disassociate &lt;floatingip-id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -658,14 +658,14 @@
<para>Deletes the floating IP <para>Deletes the floating IP
address.</para></td> address.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron floatingip-delete &lt;floatingip-id&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron floatingip-delete &lt;floatingip-id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Clears the gateway.</para></td> <para>Clears the gateway.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron router-gateway-clear router1</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron router-gateway-clear router1</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -673,14 +673,14 @@
<para>Removes the interfaces from the <para>Removes the interfaces from the
router.</para></td> router.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron router-interface-delete router1 &lt;subnet-id&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron router-interface-delete router1 &lt;subnet-id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Deletes the router.</para></td> <para>Deletes the router.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron router-delete router1</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron router-delete router1</userinput></screen>
</td> </td>
</tr> </tr>
</tbody> </tbody>
@ -898,51 +898,51 @@
<para>Creates a security group for our web <para>Creates a security group for our web
servers.</para></td> servers.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron security-group-create webservers --description "security group for webservers"</userinput></screen></td> <screen><prompt>$</prompt> <userinput>neutron security-group-create webservers --description "security group for webservers"</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td><para>Lists security groups.</para></td> <td><para>Lists security groups.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron security-group-list</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron security-group-list</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Creates a security group rule to <para>Creates a security group rule to
allow port 80 ingress.</para></td> allow port 80 ingress.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron security-group-rule-create --direction ingress --protocol tcp --port_range_min 80 --port_range_max 80 &lt;security_group_uuid&gt;</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron security-group-rule-create --direction ingress --protocol tcp --port_range_min 80 --port_range_max 80 &lt;security_group_uuid&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Lists security group <para>Lists security group
rules.</para></td> rules.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron security-group-rule-list</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron security-group-rule-list</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td><para>Deletes a security group <td><para>Deletes a security group
rule.</para></td> rule.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron security-group-rule-delete &lt;security_group_rule_uuid&gt;</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron security-group-rule-delete &lt;security_group_rule_uuid&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Deletes a security <para>Deletes a security
group.</para></td> group.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron security-group-delete &lt;security_group_uuid&gt;</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron security-group-delete &lt;security_group_uuid&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td><para>Creates a port and associates two <td><para>Creates a port and associates two
security groups.</para></td> security groups.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron port-create --security-group &lt;security_group_id1&gt; --security-group &lt;security_group_id2&gt; &lt;network_id&gt;</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron port-create --security-group &lt;security_group_id1&gt; --security-group &lt;security_group_id2&gt; &lt;network_id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Removes security groups from a <para>Removes security groups from a
port.</para></td> port.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron port-update --no-security-groups &lt;port_id&gt;</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron port-update --no-security-groups &lt;port_id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
</tbody> </tbody>
@ -989,15 +989,15 @@
option is required for pool option is required for pool
creation.</para></td> creation.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron lb-pool-create --lb-method ROUND_ROBIN --name mypool --protocol HTTP --subnet-id &lt;subnet-uuid&gt; <parameter>--provider &lt;provider_name&gt;</parameter></userinput></screen></td> <screen><prompt>$</prompt> <userinput>neutron lb-pool-create --lb-method ROUND_ROBIN --name mypool --protocol HTTP --subnet-id &lt;subnet-uuid&gt; <parameter>--provider &lt;provider_name&gt;</parameter></userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Associates two web servers with <para>Associates two web servers with
pool.</para></td> pool.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron lb-member-create --address &lt;webserver one IP&gt; --protocol-port 80 mypool</userinput> <screen><prompt>$</prompt> <userinput>neutron lb-member-create --address &lt;webserver one IP&gt; --protocol-port 80 mypool</userinput>
<prompt>#</prompt> <userinput>neutron lb-member-create --address &lt;webserver two IP&gt; --protocol-port 80 mypool</userinput></screen></td> <prompt>$</prompt> <userinput>neutron lb-member-create --address &lt;webserver two IP&gt; --protocol-port 80 mypool</userinput></screen></td>
</tr> </tr>
<tr> <tr>
<td> <td>
@ -1005,13 +1005,13 @@
make sure our instances are still running make sure our instances are still running
on the specified on the specified
protocol-port.</para></td> protocol-port.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron lb-healthmonitor-create --delay 3 --type HTTP --max-retries 3 --timeout 3</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron lb-healthmonitor-create --delay 3 --type HTTP --max-retries 3 --timeout 3</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td><para>Associates a health monitor with <td><para>Associates a health monitor with
pool.</para></td> pool.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron lb-healthmonitor-associate &lt;healthmonitor-uuid&gt; mypool</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron lb-healthmonitor-associate &lt;healthmonitor-uuid&gt; mypool</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -1021,7 +1021,7 @@
directs the requests to one of the pool directs the requests to one of the pool
members.</para></td> members.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron lb-vip-create --name myvip --protocol-port 80 --protocol HTTP --subnet-id &lt;subnet-uuid&gt; mypool</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron lb-vip-create --name myvip --protocol-port 80 --protocol HTTP --subnet-id &lt;subnet-uuid&gt; mypool</userinput></screen>
</td> </td>
</tr> </tr>
</tbody> </tbody>
@ -1371,7 +1371,7 @@
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Create a firewall rule:</para> <para>Create a firewall rule:</para>
<screen><prompt>#</prompt> <userinput>neutron firewall-rule-create --protocol &lt;tcp|udp|icmp|any&gt; --destination-port &lt;port-range&gt; --action &lt;allow|deny&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron firewall-rule-create --protocol &lt;tcp|udp|icmp|any&gt; --destination-port &lt;port-range&gt; --action &lt;allow|deny&gt;</userinput></screen>
<para>The CLI requires that a protocol value be <para>The CLI requires that a protocol value be
provided. If the rule is protocol agnostic, provided. If the rule is protocol agnostic,
the 'any' value can be used.</para> the 'any' value can be used.</para>
@ -1382,7 +1382,7 @@
</listitem> </listitem>
<listitem> <listitem>
<para>Create a firewall policy:</para> <para>Create a firewall policy:</para>
<screen><prompt>#</prompt> <userinput>neutron firewall-policy-create --firewall-rules "&lt;firewall-rule ids or names separated by space&gt;" myfirewallpolicy</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron firewall-policy-create --firewall-rules "&lt;firewall-rule ids or names separated by space&gt;" myfirewallpolicy</userinput></screen>
<para>The order of the rules specified above is <para>The order of the rules specified above is
important. A firewall policy can be created important. A firewall policy can be created
without any rules and rules can be added later without any rules and rules can be added later
@ -1402,7 +1402,7 @@
</listitem> </listitem>
<listitem> <listitem>
<para>Create a firewall:</para> <para>Create a firewall:</para>
<screen><prompt>#</prompt> <userinput>neutron firewall-create &lt;firewall-policy-uuid&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron firewall-create &lt;firewall-policy-uuid&gt;</userinput></screen>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<note> <note>
@ -1437,12 +1437,12 @@
<listitem> <listitem>
<para>Create a port with a specific <para>Create a port with a specific
allowed-address-pairs:</para> allowed-address-pairs:</para>
<screen><prompt>#</prompt> <userinput>neutron port-create net1 --allowed-address-pairs type=dict list=true mac_address=&lt;mac_address&gt;,ip_address=&lt;ip_cidr&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron port-create net1 --allowed-address-pairs type=dict list=true mac_address=&lt;mac_address&gt;,ip_address=&lt;ip_cidr&gt;</userinput></screen>
</listitem> </listitem>
<listitem> <listitem>
<para>Update a port adding <para>Update a port adding
allowed-address-pairs:</para> allowed-address-pairs:</para>
<screen><prompt>#</prompt> <userinput>neutron port-update &lt;port-uuid&gt; --allowed-address-pairs type=dict list=true mac_address=&lt;mac_address&gt;,ip_address=&lt;ip_cidr&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron port-update &lt;port-uuid&gt; --allowed-address-pairs type=dict list=true mac_address=&lt;mac_address&gt;,ip_address=&lt;ip_cidr&gt;</userinput></screen>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<note> <note>
@ -1604,7 +1604,7 @@
<para>Creates QoS Queue <para>Creates QoS Queue
(admin-only).</para></td> (admin-only).</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron queue-create--min 10 --max 1000 myqueue</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron queue-create--min 10 --max 1000 myqueue</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -1612,20 +1612,20 @@
<para>Associates a queue with a <para>Associates a queue with a
network.</para></td> network.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron net-create network --queue_id=&lt;queue_id&gt;</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron net-create network --queue_id=&lt;queue_id&gt;</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td> <td>
<para>Creates a default system <para>Creates a default system
queue.</para></td> queue.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron queue-create --default True --min 10 --max 2000 default</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron queue-create --default True --min 10 --max 2000 default</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
<td><para>Lists QoS <td><para>Lists QoS
queues.</para></td> queues.</para></td>
<td><screen><prompt>#</prompt> <userinput>neutron queue-list</userinput></screen> <td><screen><prompt>$</prompt> <userinput>neutron queue-list</userinput></screen>
</td> </td>
</tr> </tr>
<tr> <tr>
@ -1633,7 +1633,7 @@
<para>Deletes a QoS <para>Deletes a QoS
queue.</para></td> queue.</para></td>
<td> <td>
<screen><prompt>#</prompt> <userinput>neutron queue-delete &lt;queue_id or name&gt;'</userinput></screen> <screen><prompt>$</prompt> <userinput>neutron queue-delete &lt;queue_id or name&gt;'</userinput></screen>
</td> </td>
</tr> </tr>
</tbody> </tbody>
@ -1712,11 +1712,11 @@
<title>VMware NSX L3 extension operations</title> <title>VMware NSX L3 extension operations</title>
<para>Create external network and map it to a <para>Create external network and map it to a
specific NSX gateway service:</para> specific NSX gateway service:</para>
<screen><prompt>#</prompt> <userinput>neutron net-create public --router:external=True --provider:network_type l3_ext \ <screen><prompt>$</prompt> <userinput>neutron net-create public --router:external=True --provider:network_type l3_ext \
--provider:physical_network &lt;L3-Gateway-Service-UUID&gt;</userinput></screen> --provider:physical_network &lt;L3-Gateway-Service-UUID&gt;</userinput></screen>
<para>Terminate traffic on a specific VLAN from a <para>Terminate traffic on a specific VLAN from a
NSX gateway service:</para> NSX gateway service:</para>
<screen><prompt>#</prompt> <userinput>neutron net-create public --router:external=True --provider:network_type l3_ext \ <screen><prompt>$</prompt> <userinput>neutron net-create public --router:external=True --provider:network_type l3_ext \
--provider:physical_network &lt;L3-Gateway-Service-UUID&gt; --provider:segmentation_id &lt;VLAN_ID&gt;</userinput></screen> --provider:physical_network &lt;L3-Gateway-Service-UUID&gt; --provider:segmentation_id &lt;VLAN_ID&gt;</userinput></screen>
</section> </section>
</section> </section>
@ -1966,17 +1966,17 @@
<para>Update a router with rules to permit traffic <para>Update a router with rules to permit traffic
by default but block traffic from external by default but block traffic from external
networks to the 10.10.10.0/24 subnet:</para> networks to the 10.10.10.0/24 subnet:</para>
<screen><prompt>#</prompt> <userinput>neutron router-update <replaceable>Router-UUID</replaceable> --router_rules type=dict list=true\ <screen><prompt>$</prompt> <userinput>neutron router-update <replaceable>Router-UUID</replaceable> --router_rules type=dict list=true\
source=any,destination=any,action=permit \ source=any,destination=any,action=permit \
source=external,destination=10.10.10.0/24,action=deny</userinput></screen> source=external,destination=10.10.10.0/24,action=deny</userinput></screen>
<para>Specify alternate next-hop addresses for a <para>Specify alternate next-hop addresses for a
specific subnet:</para> specific subnet:</para>
<screen><prompt>#</prompt> <userinput>neutron router-update <replaceable>Router-UUID</replaceable> --router_rules type=dict list=true\ <screen><prompt>$</prompt> <userinput>neutron router-update <replaceable>Router-UUID</replaceable> --router_rules type=dict list=true\
source=any,destination=any,action=permit \ source=any,destination=any,action=permit \
source=10.10.10.0/24,destination=any,action=permit,nexthops=10.10.10.254+10.10.10.253</userinput></screen> source=10.10.10.0/24,destination=any,action=permit,nexthops=10.10.10.254+10.10.10.253</userinput></screen>
<para>Block traffic between two subnets while <para>Block traffic between two subnets while
allowing everything else:</para> allowing everything else:</para>
<screen><prompt>#</prompt> <userinput>neutron router-update <replaceable>Router-UUID</replaceable> --router_rules type=dict list=true\ <screen><prompt>$</prompt> <userinput>neutron router-update <replaceable>Router-UUID</replaceable> --router_rules type=dict list=true\
source=any,destination=any,action=permit \ source=any,destination=any,action=permit \
source=10.10.10.0/24,destination=10.20.20.20/24,action=deny</userinput></screen> source=10.10.10.0/24,destination=10.20.20.20/24,action=deny</userinput></screen>
</section> </section>