Few crucial mistakes in Cinder installation manual

Bug #1153869 reported by Igor Hrcek
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
High
Anne Gentle

Bug Description

Everything from this bug report is related to this manual:
http://docs.openstack.org/trunk/openstack-compute/install/apt/content/osfolubuntu-cinder.html

First error is:
"Edit /etc/cinder/api-paste.init (filter authtoken)."

It's typo, insead of init should be ini.

If you follow this manual to the letter there is a chance that you encounter error such is this:
2013-03-12 01:35:43 1248 TRACE cinder.openstack.common.rpc.amqp ISCSITargetCreateFailed: Failed to create iscsi target for volume volume-137641b2-af72-4a2f-b243-65fdccd38780.

This error is presented in cinder-volume.log while trying to create cinder volume which is 1 GB in size. In order to fix this issue, these fixes are needed to be done:
- change content of the /etc/tgt/targets.conf from "include /etc/tgt/conf.d/*.conf" to:
include /etc/tgt/conf.d/cinder_tgt.conf
include /etc/tgt/conf.d/cinder.conf
default-driver iscsi

Then user should restart tgt and cinder-* services in order to make Cinder work correctly.

I have not encountered this behavior at the first time I was installing Cinder, but next time while using exact same configuration for some reason I encountered this bug. I think that these instructions should find their way into official installation manual for troubleshooting.

Tags: cinder
Tom Fifield (fifieldt)
Changed in openstack-manuals:
status: New → Confirmed
importance: Undecided → High
Anne Gentle (annegentle)
Changed in openstack-manuals:
assignee: nobody → Anne Gentle (annegentle)
Changed in openstack-manuals:
status: Confirmed → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (master)

Reviewed: https://review.openstack.org/23625
Committed: http://github.com/openstack/openstack-manuals/commit/6712435ff8b9b856d24740ee95b54ea0afd871e0
Submitter: Jenkins
Branch: master

commit 6712435ff8b9b856d24740ee95b54ea0afd871e0
Author: annegentle <email address hidden>
Date: Tue Mar 5 16:23:08 2013 -0600

    Removes nova-volumes/nova-volume surgically, replace with Block
    Storage.

    Not sure about lgm vs tgts, etc, in the configuration sections. It
    seems ok to leave both as examples but needs review.

    Fix bug 1007528
    Fix bug 1074200
    Fix bug 1078353
    Fix bug 1153869

    Patchset addresses reviewer's comments.

    Patchset fixes new bug, init should be ini and troubleshooting.

    Patchset addresses question about networking.

    Change-Id: Ib6f325ba11c5cff01364ef787c52cdc57ee8f70f

Changed in openstack-manuals:
status: In Progress → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.