Bug 1114660 - add documentation to match changes for EQL support for foreman
Summary: add documentation to match changes for EQL support for foreman
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: doc-Cloud_Administrator_Guide
Version: 5.0 (RHEL 7)
Hardware: All
OS: Linux
medium
medium
Target Milestone: ga
: 5.0 (RHEL 7)
Assignee: Don Domingo
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On: 1091536 1094810 1126561 1126844 1132552
Blocks: 1093544
TreeView+ depends on / blocked
 
Reported: 2014-06-30 14:59 UTC by arkady kanevsky
Modified: 2019-12-09 19:25 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
You can now configure Dell EqualLogic storage device settings through the Red Hat Enterprise Linux OpenStack Platform Installer.
Clone Of:
Environment:
Last Closed: 2014-09-03 00:14:02 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
New EQL volume size reporting subsection for Section 5.4 (325.49 KB, application/vnd.oasis.opendocument.text)
2014-07-24 15:38 UTC, Dale McDonald
no flags Details
Text copy with screen output extracted from .odt graphics (8.14 KB, text/plain)
2014-07-24 20:16 UTC, Dale McDonald
no flags Details
new EQL size troubleshooting section revised (383.96 KB, application/pdf)
2014-08-01 03:55 UTC, Don Domingo
no flags Details
PDF review comments (386.95 KB, application/pdf)
2014-08-01 13:28 UTC, Dale McDonald
no flags Details
new EQL size troubleshooting section revised (361.01 KB, application/pdf)
2014-08-04 03:04 UTC, Don Domingo
no flags Details

Description arkady kanevsky 2014-06-30 14:59:47 UTC
Description of problem:
Add EQL support via Foreman to relevant docs  

Version-Release number of selected component (if applicable):
RHEL-OSP5 A) GA

How reproducible:
N/A

Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:

Comment 1 arkady kanevsky 2014-06-30 15:13:03 UTC
Text to be provided.
Also expect a bug for Configuration Reference Guide, Installation and Configuration Guide, and/or Release notes.

Comment 2 arkady kanevsky 2014-06-30 15:13:35 UTC
Text to be provided.
Also expect a bug for Configuration Reference Guide, Installation and Configuration Guide, and/or Release notes.

Comment 4 Dale McDonald 2014-07-07 13:58:08 UTC
Section 5.3:
Suggested verbiage for a proposed new subsection, "Configure a Dell EqualLogic storage back end", to follow soon.

Comment 5 Summer Long 2014-07-21 00:33:39 UTC
Assigning to Andrew Dahms, as the designated author for RHELOSP Installer/Foreman issues.

Comment 6 Dale McDonald 2014-07-21 20:13:21 UTC
These changes are for Section 5.3.4. Configure a multiple-storage back-end.

Change #1 First paragraph, 2nd sentence:

* Currently: "Basically, multi back-end launches one cinder-volume for each back-end."
* Should be: "Basically, multi back-end launches one cinder-volume for each back-end or back-end pool."


Change #2 Configure Block Storage scheduler multi back-end, step #2, 2nd sentence:

* Currently: "The CapacityWeigher attributes higher scores to back-ends with the most available."
* Should be: "The CapacityWeigher attributes higher scores to back-ends with the most available capacity."


Notes: 
* Change #1 above has been submitted to the upstream OpenStack Cloud Administrator Guide, Bug #1346517.

* Change #2 above is already in the upstream OpenStack Cloud Administrator Guide, in the Configure Block Storage scheduler multi back end subsection, under Section 6. Block Storage.

* A new EqualLogic section for creating a volume from an image is currently being written, and will be submitted soon.

Comment 7 Dale McDonald 2014-07-24 15:36:58 UTC
Request a new section be created in Section 5.4 Troubleshoot Your Installation.

This new section is tentatively titled, "Troubleshooting Volumes Size Reporting Discrepancies for EQL Storage".

Attached please find a LibreOffice .odt file that contains the requested verbiage. Note that there are graphics of CLI output in the document; will abide by your judgement as to whether or not to use them.

If you would prefer plain text instead of .odt, please let me know.  Thank you.

Comment 8 Dale McDonald 2014-07-24 15:38:24 UTC
Created attachment 920597 [details]
New EQL volume size reporting subsection for Section 5.4

Comment 9 Dale McDonald 2014-07-24 20:08:56 UTC
Attaching text version, with screen output extracted from the graphics in the .odt file.

Comment 10 Dale McDonald 2014-07-24 20:16:18 UTC
Created attachment 920720 [details]
Text copy with screen output extracted from .odt graphics

Comment 11 Dale McDonald 2014-07-30 14:12:15 UTC
I noticed the "needinfo" flag.  What information is required?  As soon as I know, I'll get on it.  Thanks.

Comment 12 Don Domingo 2014-08-01 03:55:14 UTC
Created attachment 923073 [details]
new EQL size troubleshooting section revised

Hi Dale, we edited the content you provided (attached). Sorry about the confusion, looks like I NEEDINFO'd you prematurely -- I wanted to give you a chance to review before we published it.

Comment 13 Dale McDonald 2014-08-01 13:28:47 UTC
Created attachment 923320 [details]
PDF review comments

Some small edits, may have been caused by munged text.  Hopefully the PDF comments survive Bugzilla attachment & download.  If not, please contact me for specifics.

Comment 14 Don Domingo 2014-08-04 03:04:42 UTC
Created attachment 923727 [details]
new EQL size troubleshooting section revised

Thanks Dale. I've corrected the minor items and converted that one wide table into an actual table (removing the ID information) to address the width issue.

Comment 15 Dale McDonald 2014-08-05 13:18:57 UTC
Looks good to me.  Thanks!

Comment 16 Dale McDonald 2014-08-05 14:24:44 UTC
Note that an upstream bug to include this content has been opened for the OpenStack Cloud Administrator Guide.  See https://bugs.launchpad.net/openstack-manuals/+bug/1348665.

Comment 17 Don Domingo 2014-08-05 14:51:56 UTC
Verified that the content is updated:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/5/html/Cloud_Administrator_Guide/troubleshooting-cinder-install.html#section_ts_cinder_config

Deepti, have you created an upstream launchpad bug for this yet? Dale has already done this, FYI.

(In reply to Dale McDonald from comment #16)
> Note that an upstream bug to include this content has been opened for the
> OpenStack Cloud Administrator Guide.  See
> https://bugs.launchpad.net/openstack-manuals/+bug/1348665.

Comment 18 Deepti Navale 2014-08-05 23:54:36 UTC
(In reply to Don Domingo from comment #17)
> 
> Deepti, have you created an upstream launchpad bug for this yet? Dale has
> already done this, FYI.

Not yet, Don. I have assigned 1348665 to myself and will have the information in soon. 

Thanks!

> 
> (In reply to Dale McDonald from comment #16)
> > Note that an upstream bug to include this content has been opened for the
> > OpenStack Cloud Administrator Guide.  See
> > https://bugs.launchpad.net/openstack-manuals/+bug/1348665.

Comment 20 arkady kanevsky 2014-08-28 14:53:38 UTC
Scott,
why is this dependent on Staypuft support to expose EQL?
The documentation is deployment method independent.
Arkady

Comment 21 Don Domingo 2014-08-28 23:30:05 UTC
Arkady,

Just as an FYI we documented this to be agnostic to deployment method as well (meaning, we did not explicitly state that this was dependent on Staypuft support). 

(In reply to arkady kanevsky from comment #20)
> Scott,
> why is this dependent on Staypuft support to expose EQL?
> The documentation is deployment method independent.
> Arkady

Comment 22 Don Domingo 2014-09-03 00:14:02 UTC
Corresponding changes have now been merged upstream. Closing BZ. Thanks Deepti!

(In reply to Deepti Navale from comment #19)
> Hey Dale, Don
> 
> I've included this content in the upstream Cloud Admin guide and Config
> reference guides. Here are the patches:
> 
> https://review.openstack.org/113436 - CAG
> https://review.openstack.org/114865 - CRG
> 
> They have been reviewed and merged. 
> 
> Thanks!


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