Bug 1209289 - [Docs] Installing multipath should be a prerequisite for block storage
Summary: [Docs] Installing multipath should be a prerequisite for block storage
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 6.0 (Juno)
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ga
: 7.0 (Kilo)
Assignee: Radek Bíba
QA Contact: Lucy Bopf
URL:
Whiteboard:
Depends On:
Blocks: 1250289
TreeView+ depends on / blocked
 
Reported: 2015-04-07 00:56 UTC by Bryan Yount
Modified: 2020-12-21 19:36 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-12-02 12:06:51 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Knowledge Base (Solution) 1406183 0 None None None Never

Description Bryan Yount 2015-04-07 00:56:56 UTC 
Description of problem:
A customer recently deployed RHEL-OSP 6 and configured the environment to use Cinder block storage using fibre. However, none of the installation documents listed the installation of device-mapper-multipath as a requirement for Cinder. This requirement should be clearly stated.

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

Example doc:
https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux_OpenStack_Platform/6/html/Deploying_OpenStack_Learning_Environments/sect-Common_Block_Storage_Configuration.html
Comment 3 Andrew Dahms 2015-06-11 11:37:41 UTC 
Assigning to Radek for review.

Radek - when the required changes have been made, let's merge the working branch for this bug with master.

This content can be added to the Manual Setup guide in the chapter on installing the Block Storage service.
Comment 4 Radek Bíba 2015-06-12 13:24:16 UTC 
As the linked solution says, device-mapper-multipath is now required by openstack-cinder-2014.2.3-3.el7ost and openstack-nova-compute-2014.2.3-9.el7ost. As a result, you needn't specify device-mapper-multipath explicitly when you're installing the latest version of Cinder in OSP 6. Does it still make sense to specify device-mapper-multipath in the docs? Also, are there plans to add the dependency to the OSP-7 versions of the packages? I can't find copies of these bug reports planned for 7.0, and the latest packages built for 7.0 don't have this dependency.

(I'm also CCing the folks who added the deps to the OSP-6 packages.)
Comment 5 Bryan Yount 2015-06-13 00:20:23 UTC 
(In reply to Radek Bíba from comment #4)
> As the linked solution says, device-mapper-multipath is now required by
> openstack-cinder-2014.2.3-3.el7ost and
> openstack-nova-compute-2014.2.3-9.el7ost. As a result, you needn't specify
> device-mapper-multipath explicitly when you're installing the latest version
> of Cinder in OSP 6. Does it still make sense to specify
> device-mapper-multipath in the docs? Also, are there plans to add the
> dependency to the OSP-7 versions of the packages? I can't find copies of
> these bug reports planned for 7.0, and the latest packages built for 7.0
> don't have this dependency.

Thanks for the reminder about this, Radek. Now that Bug 1209336 has been resolved, and multipath is a dependency of cinder, I don't know if we need this in the docs any longer.
Comment 7 Lucy Bopf 2015-07-15 07:22:54 UTC 
The requested changes have been implemented.

Moving to VERIFIED.
Comment 8 Andrew Dahms 2015-12-02 12:06:51 UTC 
This content is now live on the Customer Portal.

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