From 2ab34e9c4a2d8dfd34e63af5550d7a85ac4f235c Mon Sep 17 00:00:00 2001 From: Martin Lopes Date: Tue, 11 Feb 2014 22:23:33 +1000 Subject: [PATCH] Applies conventions to Networking Use section Edits for punctuation and service name conventions where appropriate. Rewords a number of sentences. Change-Id: I13e06c13c4cd5446a1f4073b6dcefee0aa475ee0 Partial-Bug: #1217503 --- .../section_networking-use.xml | 63 +++++++++---------- 1 file changed, 30 insertions(+), 33 deletions(-) diff --git a/doc/admin-guide-cloud/section_networking-use.xml b/doc/admin-guide-cloud/section_networking-use.xml index 196391f894..aacda5ca32 100644 --- a/doc/admin-guide-cloud/section_networking-use.xml +++ b/doc/admin-guide-cloud/section_networking-use.xml @@ -3,8 +3,8 @@ xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"> Use Networking - You can start and stop OpenStack Networking services - using the service command. For + You can manage OpenStack Networking services using + the service command. For example: # sudo service neutron-server stop # sudo service neutron-server status @@ -20,8 +20,7 @@ Expose the Networking API to cloud tenants, - which enables them to build rich network - topologies. + enabling them to build rich network topologies. Have the cloud administrator, or an automated @@ -48,10 +47,10 @@
API abstractions The Networking v2.0 API provides control over - both L2 network topologies and the IP addresses - used on those networks (IP Address Management or - IPAM). There is also an extension to cover basic - L3 forwarding and NAT, which provides capabilities + both L2 network topologies and their allocated + IP addresses (IP Address Management or IPAM). + There is also an extension to cover basic L3 + forwarding and NAT, which provides capabilities similar to nova-network. @@ -77,13 +76,13 @@ + and other network configuration, + such as default gateways or + dns-servers, with an Networking + network. Each subnet represents + an IPv4 or IPv6 address block, + and each Networking network can + have multiple subnets.
API abstractions
Subnet Associates a block of IP addresses - and other network configuration, - such as, default gateways or - dns-servers, with an Networking - network. Each subnet represents an - IPv4 or IPv6 address block and, if - needed, each Networking network can - have multiple subnets.
Basic Networking operations - To learn about advanced capabilities that are - available through the neutron command-line - interface (CLI), read the networking section in - the OpenStack End User Guide. - This table shows example neutron commands that - enable you to complete basic Networking + To learn about advanced capabilities available + through the neutron command-line interface + (CLI), read the networking section in the OpenStack End User Guide. + This table shows example neutron commands + that enable you to complete basic network operations: @@ -472,8 +470,8 @@
Advanced Networking operations - This table shows example neutron commands that - enable you to complete advanced Networking + This table shows example Networking commands + that enable you to complete advanced network operations:
Basic Networking operations
@@ -530,9 +528,9 @@ Use Compute with Networking
Basic Compute and Networking operations - This table shows example neutron and nova - commands that enable you to complete basic Compute - and Networking operations: + This table shows example neutron and + nova commands that enable you to complete + basic VM networking operations:
Advanced Networking operations
@@ -567,8 +565,7 @@ + of the port. @@ -605,9 +602,9 @@
Advanced VM creation operations - This table shows example nova and neutron - commands that enable you to complete advanced VM - creation operations: + This table shows example nova and + neutron commands that enable you to + complete advanced VM creation operations:
Basic Compute and Networking operations
Searches for ports, but shows only the - for - the port. # neutron port-list --field mac_address --device_id=vm-id
Advanced VM creation operations