Bug 1353475 - '7.5.1. Preparing iSCSI Storage' in Administration Guide should drop EL6 only steps
Summary: '7.5.1. Preparing iSCSI Storage' in Administration Guide should drop EL6 only...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: Documentation
Version: 3.6.7
Hardware: Unspecified
OS: Unspecified
unspecified
low
Target Milestone: ovirt-3.6.10
: ---
Assignee: Megan Lewis
QA Contact: Tahlia Richardson
URL:
Whiteboard:
: 1311799 (view as bug list)
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-07-07 08:51 UTC by Jiri Belka
Modified: 2016-12-14 06:22 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-12-14 06:22:04 UTC
oVirt Team: Docs
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Jiri Belka 2016-07-07 08:51:48 UTC
Description of problem:

IMO it is too much human effort to follow EL* development and to extract parts from official EL* storage mgmt guides and too keep them up-to-date in specific related products which could work with storage service provided on such EL* machines.

ie. IMO it is enough to keep a "link" to offical docs related to iSCSI as it is in 2nd paragraph under '7.5.2. Adding iSCSI Storage' and it seems to me better to drop whole '7.5.1' section about setting up iSCSI on EL6 only.

Why? Either we should have 'Preparing iSCSI Storage' sections for both major versions (EL6, EL7) included or just drop the steps themselves and refer to official EL* docs. I would go for the latter.

(Those little notes in '7.5.1' cannot be considered exhausted steps for iSCSI storage preparation and in some cases just following the steps [ie. changing already existing iSCSI target] can be harmful to already established initiators' connections.)

Version-Release number of selected component (if applicable):
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html/Administration_Guide/sect-Preparing_and_Adding_Block_Storage.html

How reproducible:
100%

Steps to Reproduce:
1. see if 7.5.1 talks only about EL6
2.
3.

Actual results:
7.5.1 talks only about EL6 and the steps only assume clean iscsi target

Expected results:
do not document details about iscsi storage preparation in RHEVM docs, just refer to official EL* storage mgmt guides

Additional info:

Comment 1 Megan Lewis 2016-08-04 06:31:45 UTC
*** Bug 1311799 has been marked as a duplicate of this bug. ***

Comment 5 Allon Mureinik 2016-08-10 11:04:32 UTC
RHEV doesn't have any special support matrix here - if the underlying RHEL(7) supports connecting to server X, so will RHEL, regardless of whether X is targetcli from RHEL 7, tgtd from RHEL 6, an EMC-VNX machine or whathaveyou. 

Chapter 7.5.1 isn't really part of RHEV - it's about one [not particularly useful] configuring the iSCSI **server** RHEV can connect to. I tend to agree with Jiri here. This chapter can be reduced to a link in the spirit of "RHEV can connect to any iSCSI server RHEL supports. For example, you can use a different RHEL server as a storage server, see guide X, section Y for details".


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