Bug 1010807

Summary: [Doc] Add introduction to networking section
Product: Red Hat Enterprise Linux 7 Reporter: Dayle Parker <dayleparker>
Component: doc-Virtualization_Getting_Started_GuideAssignee: Jiri Herrmann <jherrman>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: medium    
Version: 7.0CC: areis, jhradile, knoel, laine, mst, tcapek
Target Milestone: rcKeywords: Documentation, Triaged
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: 971231 Environment:
Last Closed: 2017-03-29 17:36:06 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On: 971231    
Bug Blocks: 1064610, 1425467    

Comment 7 Laine Stump 2017-02-09 15:33:28 UTC
Here's an alternate that uses some of your text with a lot of additions/subtractions:

A virtual guest's connection to any network is via software network components on the physical host. These software components can be rearranged and reconfigured via libvirt's virtual network configuration, so the host can be thought of as a virtual network switch that can be configured in many different ways to fit the guest's networking needs.


By default, all guests on a single host are connected to the same libvirt virtual network (aptly named "default"). Guests on this network can all make connections with each other (bidirectional, modulo any firewalls in the guest OS' network stack or libvirt nwfilter rules attached to the guest interface), with the virtualization host (also bidirectional modulo any fireall rules), and with other hosts on the network beyond the virtualization host (outbound only, via Network Address Translation (NAT) rules added to the host system firewall).

If needed, guest interfaces can instead be connected to:

  * a network that doesn't allow any traffic beyond the virtualization host
    (referred to in some documentation as "isolated" mode).

  * a network that routes traffic between the guest and external hosts without
    performing any NAT (this allows for incoming connections but requires extra
    routing table entries for sytems on the external network. This is called
    "route" mode in libvirt's virtual network configuration and documentation)

  * a bridge device that is also connected directly to a physical
    ethernet device which is connected to the local ethernet, making the
    guest directly visible on the physical network (this also allows incoming
    connections, but doesn't require any extra routing table entries. It is
    referred to in documentation as "bridged mode")

For simple outbound-only network access from virtual machines, no additional network setup should be needed, as the network named "default" is installed along with libvirt, and automatically started when the libvirt service is started. If more advanced functionality is needed, additional networks can be created and configured using either virsh or virt-manager, and the guest XML configuration file can be edited to use one of these new networks.

From the point of view of the guest OS, a virtual network connection is no different from a normal physical network connection. For further information on configuring networks in RHEL7 guests, see the Red Hat Enterprise Linux 7 Networking Guide.