Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

This project is now read‑only. Starting Monday, February 2, please use https://ibm-ceph.atlassian.net/ for all bug tracking management.

Bug 1193736

Summary:	[doc] improve installation method for ice_setup RPM
Product:	[Red Hat Storage] Red Hat Ceph Storage	Reporter:	Ken Dreyer (Red Hat) <kdreyer>
Component:	Documentation	Assignee:	John Wilkins <jowilkin>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Hemanth Kumar <hyelloji>
Severity:	unspecified	Docs Contact:	John Wilkins <jowilkin>
Priority:	unspecified
Version:	1.2.3	CC:	sgraf
Target Milestone:	rc
Target Release:	1.2.3
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2015-10-05 22:55:08 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Ken Dreyer (Red Hat) 2015-02-18 01:32:57 UTC

Description of problem:
The current Red Hat Ceph Storage Installation Guide (e3664ecff5618a48c32930d463a5dc2161a0d5e3 in GitLab) mentions using "rpm -i" to install the ice_setup RPM. This could be improved in two ways:

1) Instead of "rpm -i", we should tell users to use "yum install". Yum can accept filenames as arguments, and it would be better to use yum so that the users will get any missing dependencies (for example, python-argparse on EL6 will be automatically resolved).

2) Instead of providing an exact RPM filename for the ice_setup RPM, we should provide a glob: "yum install /mnt/ice_setup-*.rpm" This will provide more flexibility in the documentation as we ship newer versions of the ice_setup RPM (as we invariably will have to do.)

Version-Release number of selected component (if applicable):
I'm reviewing red-hat-ceph-storage-installation.adoc, e3664ecff5618a48c32930d463a5dc2161a0d5e3 in GitLab

Comment 1 John Wilkins 2015-03-02 23:54:28 UTC

Working on the suggested method described above on RHEL 7. When using yum, I encounter the following: 

--> Finished Dependency Resolution
Error: Package: ice_setup-0.2.2-1.el6cp.noarch (/ice_setup-0.2.2-1.el6cp.noarch)
           Requires: python(abi) = 2.6
           Installed: python-2.7.5-16.el7.x86_64 (@anaconda/7.0)
               python(abi) = 2.7
               python(abi) = 2.7
 You could try using --skip-broken to work around the problem
 You could try running: rpm -Va --nofiles --nodigest

Comment 3 John Wilkins 2015-03-03 22:01:06 UTC

Made instructions generic as suggested.

Comment 4 Hemanth Kumar 2015-03-11 11:52:44 UTC

Verified the changes in the Documentation : 


then new changes made in the Guide :
sudo yum install /mnt/ice_setup-*.rpm