Bug 794801 - mention how to install a guest with virtio-scsi in the Guest Installation guide
Summary: mention how to install a guest with virtio-scsi in the Guest Installation guide
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 7
Classification: Red Hat
Component: doc-Virtualization_Deployment_and_Administration_Guide
Version: 7.0
Hardware: All
OS: Linux
high
medium
Target Milestone: rc
: 7.0
Assignee: Tahlia Richardson
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On: 808071
Blocks: 1073247
TreeView+ depends on / blocked
 
Reported: 2012-02-17 17:10 UTC by Paolo Bonzini
Modified: 2019-03-06 00:57 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
: 808071 (view as bug list)
Environment:
Last Closed: 2014-06-13 06:32:15 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Paolo Bonzini 2012-02-17 17:10:46 UTC
Section 6.2

In example 6.1, please replace the command text with the following:

virt-install \
   --name=guest1-rhel5-64 \
   --disk path=/var/lib/libvirt/images/guest1-rhel5-64.dsk,size=8,sparse=false,cache=none \
   --vnc \
   --vcpus=2 --ram=2048 \
   --location=http://example1.com/installation_tree/RHEL5.6-Server-x86_64/os \
   --network bridge=br0 \
   --os-type=linux \
   --os-variant=rhel5.4

(each line should begin with 2 or more spaces, and end at the following \ character).

Then we need another note:

Starting with Red Hat Enterprise Linux 6 update 3, the virtio-scsi
controller is available for use in guests.  If both the host and
guest support virtio-scsi, you can use it as follows:

virt-install \
   --name=guest1-rhel5-64 \
   --controller type=scsi,model=virtio-scsi \
   --disk path=/var/lib/libvirt/images/guest1-rhel5-64.dsk,size=8,bus=scsi,cache=none \
   --vnc \
   --vcpus=2 --ram=2048 \
   --location=http://example1.com/installation_tree/RHEL5.6-Server-x86_64/os \
   --network bridge=br0 \
   --os-type=linux \
   --os-variant=rhel6.3

virtio-scsi is currently a Technology Preview.  In the future,
virt-install may enable virtio-scsi automatically based on the
--os-type and --os-variant arguments.

Comment 5 Laszlo Ersek 2012-03-29 15:42:19 UTC
(In reply to comment #0)

> Starting with Red Hat Enterprise Linux 6 update 3, the virtio-scsi
> controller is available for use in guests.  If both the host and
> guest support virtio-scsi, you can use it as follows:
> 
> virt-install \
>    --name=guest1-rhel5-64 \
>    --controller type=scsi,model=virtio-scsi \
>    --disk
> path=/var/lib/libvirt/images/guest1-rhel5-64.dsk,size=8,bus=scsi,cache=none \
>    --vnc \
>    --vcpus=2 --ram=2048 \
>    --location=http://example1.com/installation_tree/RHEL5.6-Server-x86_64/os \
>    --network bridge=br0 \
>    --os-type=linux \
>    --os-variant=rhel6.3
> 
> virtio-scsi is currently a Technology Preview.  In the future,
> virt-install may enable virtio-scsi automatically based on the
> --os-type and --os-variant arguments.

The --name, --disk and --location switches imply RHEL-5.6, which is confusing.

Comment 6 Paolo Bonzini 2012-06-15 09:56:20 UTC
Laszlo is right:

virt-install \
   --name=guest1-rhel64-64 \
   --controller type=scsi,model=virtio-scsi \
   --disk path=/var/lib/libvirt/images/guest1-rhel6-64.dsk,size=8,bus=scsi,cache=none \
   --vnc \
   --vcpus=2 --ram=2048 \
   --location=http://example1.com/installation_tree/RHEL6.4-Server-x86_64/os \
   --network bridge=br0 \
   --os-type=linux \
   --os-variant=rhel6.3

Comment 7 Paolo Bonzini 2012-07-24 11:27:19 UTC
Bug 808071 will not be fixed in RHEL6.  Moving to RHEL7.

Comment 8 Dayle Parker 2012-09-03 06:06:10 UTC
Paolo, I have corrected example 6.1 with the RHEL6 guest configuration from Comment 6. Thanks for providing that.

Could you please confirm - do we need to include a note on any of this from Comment 0 (below) in the guide? 

From what I understand, the virtio-scsi driver will be available in RHEL 6.4, but the virtio-scsi controller will *not* be in RHEL 6.4. Is that correct?


(In reply to comment #0)
> 
> Then we need another note:
> 
> Starting with Red Hat Enterprise Linux 6 update 3, the virtio-scsi
> controller is available for use in guests.  If both the host and
> guest support virtio-scsi, you can use it as follows:
> 
> virt-install \
>    --name=guest1-rhel5-64 \
>    --controller type=scsi,model=virtio-scsi \
>    --disk
> path=/var/lib/libvirt/images/guest1-rhel5-64.dsk,size=8,bus=scsi,cache=none \
>    --vnc \
>    --vcpus=2 --ram=2048 \
>    --location=http://example1.com/installation_tree/RHEL5.6-Server-x86_64/os
> \
>    --network bridge=br0 \
>    --os-type=linux \
>    --os-variant=rhel6.3
> 
> virtio-scsi is currently a Technology Preview.  In the future,
> virt-install may enable virtio-scsi automatically based on the
> --os-type and --os-variant arguments.

Comment 9 Paolo Bonzini 2012-09-03 13:33:44 UTC
> Paolo, I have corrected example 6.1 with the RHEL6 guest configuration from Comment 6. Thanks for providing that.

No, that part of comment 0 was correct.  In fact, there is no need to change the text for now; the guide is already correct.  However, when adding the note it makes sense to make the two examples more similar to each other, hence the change.

The correction in example 6 should have been to the text in the new note.

All components of virtio-scsi are already in 6.3, and the controller is documented in the RHEL6 virtualization administration guide.  The problem is that virt-install was not updated to support it, so we will only document the controller in the RHEL7 installation guide.

I think we can keep this change on hold until we know whether virtio-scsi will still be TP on RHEL6.4 or not.

Comment 10 Dayle Parker 2012-09-05 03:59:54 UTC
Thanks for the info, Paolo. We'll keep the virtio-scsi and controller examples out of the 6.4 book and revisit for RHEL7.

We still need to update the example to a RHEL6 guest.

I've created https://bugzilla.redhat.com/show_bug.cgi?id=854437 for this issue. I have CCed you on that bug.


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