Bug 1114752

Placeholder for now.
Will fill the text for EQL later.

Placeholder for now.
Will fill the text for EQL later.

Created attachment 918734 [details]
Dell EQLX enhancement for Configuration Reference Guide

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.

This bug is being assigned to Andrew Dahms, who is now the designated docs specialist for Foreman.

Where do we stand on this issue?  In progress?  Thanks.

We're working to get this published this week. I've attached 1 of 2 patches related to this.

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.

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.

Created attachment 924337 [details]
draft of revised content for the Cloud Admin Guide

minor revisions from previous upload.

I think that between the two attachments (924329, 924337), the information is now fully presented.  I would like Arkady to confirm.  Thanks.

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

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

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.

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.

This is good.
Thanks Don.

Public docs now updated:

https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/5/html/Cloud_Administrator_Guide/section_manage-volumes.html#multi_backend

http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/5/html/Configuration_Reference_Guide/section_volume-drivers.html#dell-equallogic-driver

Reassigning to Deepti so upstream content gets updated as needed.

This update has been merged upstream. Changing status to CLOSED.