Bug 1114752 - [Docs] [Foreman] Add documentation to match EQL configuration support via foreman/astapor
Summary: [Docs] [Foreman] Add documentation to match EQL configuration support via for...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: doc-Configuration_Reference_Guide
Version: 5.0 (RHEL 7)
Hardware: All
OS: Linux
high
high
Target Milestone: ga
: 5.0 (RHEL 7)
Assignee: Deepti Navale
QA Contact: Summer Long
URL:
Whiteboard:
Depends On: 1091536 1094810 1126561 1126844 1132552
Blocks: 1093544 1116865 1234669
TreeView+ depends on / blocked
 
Reported: 2014-06-30 21:24 UTC by arkady kanevsky
Modified: 2019-12-09 19:26 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Feature: EQL configuration via Foreman/Astapor Reason: Result (if any):
Clone Of:
: 1116865 (view as bug list)
Environment:
Last Closed: 2015-06-15 03:28:15 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
Dell EQLX enhancement for Configuration Reference Guide (216.64 KB, application/pdf)
2014-07-17 14:22 UTC, Dale McDonald
no flags Details
draft of revised content for the Config Reference Guide (130.64 KB, application/pdf)
2014-08-06 01:45 UTC, Don Domingo
no flags Details
draft of revised content for the Cloud Admin Guide (250.81 KB, application/pdf)
2014-08-06 01:47 UTC, Don Domingo
no flags Details
draft of revised content for the Cloud Admin Guide (250.92 KB, application/pdf)
2014-08-06 03:13 UTC, Don Domingo
no flags Details

Description arkady kanevsky 2014-06-30 21:24:30 UTC
Description of problem:
Config guide should properly reflect EQL configuration for OSP solution as added by RFEs

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

How reproducible:
N/A

Steps to Reproduce:
1.
2.
3.

Actual results:


Expected results:


Additional info:

Comment 2 arkady kanevsky 2014-06-30 21:32:28 UTC
Placeholder for now.
Will fill the text for EQL later.

Comment 3 arkady kanevsky 2014-06-30 21:32:47 UTC
Placeholder for now.
Will fill the text for EQL later.

Comment 4 Dale McDonald 2014-07-17 14:22:39 UTC
Created attachment 918734 [details]
Dell EQLX enhancement for Configuration Reference Guide

Comment 5 Dale McDonald 2014-07-17 14:24:43 UTC
This is intended to replace Section 1.3.2 Dell EqualLogic volume driver.  Any references to other sections are current as of 07/16/2014 - if outdated, please change as required.

Comment 6 Martin Lopes 2014-07-18 02:00:55 UTC
This bug is being assigned to Andrew Dahms, who is now the designated docs specialist for Foreman.

Comment 7 Dale McDonald 2014-08-05 15:25:11 UTC
Where do we stand on this issue?  In progress?  Thanks.

Comment 8 Don Domingo 2014-08-06 00:08:21 UTC
We're working to get this published this week. I've attached 1 of 2 patches related to this.

Comment 9 Don Domingo 2014-08-06 01:45:57 UTC
Created attachment 924328 [details]
draft of revised content for the Config Reference Guide

Dale, I'm attaching 1 of 2 draft changes related to this BZ. This one should cover the basics of a simple, single-instance (required and optional settings) back-end. Specifically, this section appears in the Configuration Reference Guide. Let me know if any further revisions are required.

Comment 10 Don Domingo 2014-08-06 01:47:28 UTC
Created attachment 924329 [details]
draft of revised content for the Cloud Admin Guide

Here's 2 of 2; this should cover how to set up multiple Dell EqualLogic back-ends.

Comment 11 Don Domingo 2014-08-06 03:13:37 UTC
Created attachment 924337 [details]
draft of revised content for the Cloud Admin Guide

minor revisions from previous upload.

Comment 12 Dale McDonald 2014-08-06 13:44:44 UTC
I think that between the two attachments (924329, 924337), the information is now fully presented.  I would like Arkady to confirm.  Thanks.

Comment 13 arkady kanevsky 2014-08-10 20:02:31 UTC
Comment on attachment 924337 [details]
draft of revised content for the Cloud Admin Guide

For cloud admin guide in example
suggest changing san_ip from IP_EQLX to IP_EQLX1 for first backend and IP_EQLX2 for the second backend.

[backend1]
volume_driver=cinder.volume.drivers.eqlx.DellEQLSanISCSIDriver
volume_backend_name=backend1
san_ip=IP_EQLX1
san_login=SAN_UNAME
san_password=SAN_PW
eqlx_group_name=EQLX_GROUP
eqlx_pool=EQLX_POOL
[backend2]
volume_driver=cinder.volume.drivers.eqlx.DellEQLSanISCSIDriver
volume_backend_name=backend2
san_ip=IP_EQLX2
san_login=SAN_UNAME
san_password=SAN_PW
eqlx_group_name=EQLX_GROUP
eqlx_pool=EQLX_POOL

Comment 14 arkady kanevsky 2014-08-10 20:11:52 UTC
For Config reference guide, please modify first entry for the list below, as volume extend is required operation for volumes for IceHouse.

The Dell EqualLogic volume driver interacts with configured Dell EqualLogic Groups and supports various
operations, including:
Volume creation, deletion AND EXTENSION
Volume attachment and detachment
Snapshot creation and deletion
Clone creation

Comment 15 Don Domingo 2014-08-11 02:48:40 UTC
Thanks Arkady. In line with that, I added the following note to the same section in the Cloud Admin Guide as well:

<quote>
The IP_EQLX1 and IP_EQLX1 refer to the IP addresses used to reach the Dell EqualLogic Group of backend1 and backend2 through SSH, respectively. 
</quote>

Please verify and I will have it published on our portal, and processed for upstream as well.

Comment 17 Don Domingo 2014-08-11 03:41:53 UTC
Sorry, I meant:

<quote>
The IP_EQLX1 and IP_EQLX2 refer to the IP addresses used to reach the Dell EqualLogic Group of backend1 and backend2 through SSH, respectively. 
</quote>


(In reply to Don Domingo from comment #15)
> Thanks Arkady. In line with that, I added the following note to the same
> section in the Cloud Admin Guide as well:
> 
> <quote>
> The IP_EQLX1 and IP_EQLX1 refer to the IP addresses used to reach the Dell
> EqualLogic Group of backend1 and backend2 through SSH, respectively. 
> </quote>
> 
> Please verify and I will have it published on our portal, and processed for
> upstream as well.

Comment 18 arkady kanevsky 2014-08-11 14:00:09 UTC
This is good.
Thanks Don.

Comment 22 Deepti Navale 2015-06-15 03:28:15 UTC
This update has been merged upstream. Changing status to CLOSED.


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