Bug 1330773 - Requesting Additional Examples In Chapter 3.2, "Creating Guests With virt-install".
Summary: Requesting Additional Examples In Chapter 3.2, "Creating Guests With virt-ins...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: doc-Virtualization_Deployment_and_Administration_Guide
Version: 7.4
Hardware: All
OS: Linux
high
medium
Target Milestone: rc
: ---
Assignee: Jiri Herrmann
QA Contact:
URL:
Whiteboard:
Depends On:
Blocks: 1330775
TreeView+ depends on / blocked
 
Reported: 2016-04-26 23:07 UTC by Bernie Hoefer
Modified: 2019-10-10 11:59 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
: 1330775 (view as bug list)
Environment:
Last Closed: 2016-11-08 17:23:42 UTC
Target Upstream Version:


Attachments (Terms of Use)

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.


Note You need to log in before you can comment on or make changes to this bug.