Bug 1330773

Summary: Requesting Additional Examples In Chapter 3.2, "Creating Guests With virt-install".
Product: Red Hat Enterprise Linux 7 Reporter: Bernie Hoefer <bhoefer>
Component: doc-Virtualization_Deployment_and_Administration_GuideAssignee: Jiri Herrmann <jherrman>
Status: CLOSED CURRENTRELEASE QA Contact:
Severity: medium Docs Contact:
Priority: high    
Version: 7.4CC: pchavan, rhel-docs
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of:
: 1330775 (view as bug list) Environment:
Last Closed: 2016-11-08 17:23:42 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:
Bug Depends On:    
Bug Blocks: 1330775    

Description Bernie Hoefer 2016-04-26 23:07:20 UTC
RHEL7's anaconda boot parameter "asknetwork" is deprecated.  Due to this, those people who have experience using virt-install to create RHEL5 or RHEL6 guests on a DHCP-less network are bewildered why a RHEL7 guest fails to install.  (See <https://access.redhat.com/solutions/511263> for the answer.)

A user that has experienced this problem would like to see Chapter 3.2 of the _Virtualization Deployment And Administration Guide_ changed to include a 3.2.z section centered around RHEL7 guests under different network configurations.  This section would include 3 examples of installing RHEL7 guests using virt-install when:

1.  using libvirtd's NAT virtual network switch.  The virt-install command would specify either "--network=default" or leave the "--network" option off since it defaults to the default virbr0 network.  The command would also possibly include '--extra-args="ip=dhcp"', though that is the default if not explicitly set.

2.  using an external DHCP server if by specifying the host's bridge interface.  This example would have to inform the reader about the need to setup a br0 interface with the host's eth0 interface as a slave.  The virt-install command would specify "--network=br0" and possibly '--extra-args="ip=dhcp"'.  (The user also suggested linking to RHEL7's DHCP networking guide -- specifically <https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Networking_Guide/sec-dhcp-configuring-server.html> -- for readers who want to know how to setup an external DHCP server.  That may be extraneous, but will let the documentation folks decide.)

3.  using an external static IPv4 address.  This example would have to inform the reader about the need to setup a br0 interface with the host's eth0 interface as a slave.  The virt-install command would specify "--network=br0" and '--extra-args="ip=<ip>::<gateway>:<netmask>:<hostname>:<interface>:<autoconf>"'.  It would probably be good to give an real-value example like "ip=192.168.1.2::192.168.1.1:255.255.255.0:test.example.com:eth0:none" so the reader knows for sure what kind of values to put in.