Bug 1462085
| Summary: | [Docs][Admin] Improve Virtio-SCSI Documentation | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Virtualization Manager | Reporter: | Germano Veit Michel <gveitmic> |
| Component: | Documentation | Assignee: | Avital Pinnick <apinnick> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Megan Lewis <melewis> |
| Severity: | high | Docs Contact: | |
| Priority: | high | ||
| Version: | 4.1.2 | CC: | gveitmic, lbopf, lsurette, rbalakri, srevivo, ykaul, ylavi |
| Target Milestone: | ovirt-4.1.4 | ||
| Target Release: | --- | ||
| Hardware: | x86_64 | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | If docs needed, set a value | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2017-08-08 07:26:51 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | Docs | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
|
Description
Germano Veit Michel
2017-06-16 07:16:28 UTC
(In reply to Germano Veit Michel from comment #0) > Description of problem: > > [1] is a section about Virtual Machine Disks. > > a) In 11.6.2, in tables 11.2, 11.3 and 11.4 the "interface" row lacks a > reference to Virtio-SCSI. > > b) It's missing that for the Virtio-SCSI option to show up, we need to set > VM-> Edit->Resource Allocation-> Virtio-SCSI Enable, otherwise it doesn't > show up. We should fix this, it's an easy fix. > > c) It's missing a better description in the initial sections (11.1 or 11.2?) > about the differences between IDE, Virtio and Virtio-SCSI (number of > supported disks, performance, discard, passthrough...) and a general > recommendations. > > d) If we add the above (c) in separate section, then there is no need to > repeat 3 times (table 11.2, 11.3 and 11.4) that Windows does not ship with > Virtio and the drivers needs to be installed and also that and Virtio is > included in RHEL5+ or higher. We should either open an RHEL bug to provide this info or link to it if it exists. > > [1] > https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/ > html-single/administration_guide/#chap-Virtual_Machine_Disks Assigning to Avital for review. Avital, a) and b) should be simple enough to fix. For c) and d), I'd suggest looking for RHEL documentation that describes those different interface types, since they are not specific to RHV. The scope of this fix has expanded. The documentation, as it stands, conflated two procedures, creating floating virtual disks ("Creating Virtual Floating Disks") and creating attached virtual disks ("Explanation of Settings in the New Virtual Disk Window"), that is, non-floating virtual disks.
I think that a UI bug should be submitted for the Administration Portal. It does not make sense to have two windows, one for creating floating virtual disks and one for creating attached virtual disks, to both have the same name, "New Virtual Disk." This was a contributing factor to the confusion.
Germano and I have discussed the differences between virtio and virtio-scsi, so that section will be expanded.
Updated Administration Guide 4.1: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/administration_guide |